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WELCOME 
to The MagP1 84 


hope you’re enjoying Raspberry Pi 4. We love the programmable 
i computer and believe it’s capable of becoming the main desktop 
machine in the home. Starting from $35, that’s a big attraction. And 
lots of people are discovering Raspberry Pi for the first time. 

Our Raspberry Pi Starter Guide (page 24) is designed to help these 
newcomers with Raspberry Pi 4, and even long-standing Raspberry Pi 
users will learn something new. 

More importantly, the whole of The MagPi magazine is designed to 
get you beyond the board and into building projects. So, if you’ve ever 
fancied making a low-cost wheeled robot, now is your chance (page 36). 
And, if you are more advanced with robots, we’ve got a tutorial on using 
CircuitPython to control servos and motors (page 44). 

What about retro gaming? We look at how to build a space shooter 
with PICO-8 (page 54). Advanced makers might want to check out the 
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Lucy 
Hattersley 


Editor of The 
MagPi. Tunnels 
from a terminal like 
an over-caffeinated 
mole. Does not 
play Mario Maker. 
Is ona rickety 
seaplane holiday, 
so may not make it 
back next month. 
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Squeeze Controller (upcycled from an old hand-dynamo). This month, 

Mike Cook uses that controller to design an LED racing game (page 58). 
And last, but definitely not least: Demolition Man is a hilarious 

project by PJ Evans that uses AI to detect when you say naughty words, GET A 

and prints out a ticket on a thermal RASPBERRY PI 

printer (page 50). There’s lots of fun ZERO W KIT 

to be had with a Raspberry Pi and the eu 


AL RASPBERRY Pl ane 
right project. 


The point of Raspberry Pi isn’t just 


to build a low-cost computer. It’s 
what you build with that computer. 
Make something amazing and share it 
with the rest of the community. 


aioe 


Lucy Hattersley Editor 


+ PAGES OF TUTORIALS JIMMd © 
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Entries open 


for Pi Wars 2020 


Raspberry Pi fans get to design fiendishly challenging courses to foil ever more 
sophisticated robots for next year's Pi Wars. Fantastic news, thinks Rosie Hattersley 


A Malaysia's Team MYRA 
celebrate their Pi Wars 2019 win 
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are already well under way for a firm fixture 

on the Raspberry Pi calendar: Pi Wars 2020. 
The sixth Pi Wars event is due to take place in 
May 2020. Entries open at the start of August and 
must be in by 12 September. 

Course favourites Pi Noon - in which robots 
have to burst a balloon on their opponent’s robot 
using a spiked probe — and the Obstacle Course 
will return, the latter with new obstacles. 

This Pi Wars is being opened up to wannabe 
track engineers. Most Pi Wars challenges are 
built by event co-organiser Tim Richardson, and 
he’s keen to open up the course design to the 
rest of the community. Brilliantly, this means 
the rest of us get to pitch ideas for courses, and 
even offer our expertise in building them. 


[ t may be the height of summer, but things 


On course for success 

Pi Wars co-organiser Mike Horne says, “What 
makes 2020 special is that, for the first time, 

we are asking the community to contribute to 
the event by proposing and building courses. 


MéigPi 


Robots duke it 
out in the Pi Noon 
Pi corral 


Awalking robot 
tackles the 
Obstacle Course 


At Pi Wars 2019, a special presentation was made 
to co-organisers Mike Horne and Tim Richardson 


We’ve asked as many people as possible to 
propose courses for the competition, and then 
to build them.” 

This will also free up the indefatigable Tim 
to work on fiendishly clever new advances and 
surprises for Pi Wars 2020. 

Previous events filled up very quickly, so get 
your skates on if you’d like to apply. There are 
two categories: School and Kids’ Clubs teams 
on the Saturday, and then All Other Teams on 
the Sunday. To keep things competitive, teams 
entering are also split by levels of prior Pi Wars 
experience. “We’ve found the format works well, 
allowing us to have a good spread of teams,” says 
Mike. Volunteers can also apply via the Pi Wars 
website: piwars.org. 


Pi Wars 2019 featured 
some very clever, and 
cute, robots 


Image Credits: 
Christopher Parrot, 
SimUK, Team MYRA, 
Mark Mellors, Colin Grant 
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Faster, stronger, and with more possibilities than ever before, this is the Raspberry Pi 4. 


Advanced connectivity, flexible RAM options, and a 1.5GHz quad-core ARM Cortex-A72 CPU. 
Find your Raspberry Pi 4 and all the accessories at OKdo.com 


OKDO.COM 


OKDO Pié SLIDE CASE 

Protective case with a smooth 
slide action. Available in Black, 
White or Clear 


OKDO Pid POWER SUPPLY ™ 
Start straight from the box with 

a power supply that easily adapts 

to all international sockets. 


DESIGN THE WORLD 
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Smart Home 
Herb Garden 


Growing herbs using Google's Smart Home API 
makes for gutomated flavour in your cooking. 
Rob Zwetsloot grabs a bunch 


may have encountered some problems. Coriander 

flopping about everywhere. Rosemary never 
really regrowing. Basil growing out of control. Then 
you leave the house for a few days and come back to 
withered herbs. It’s tricky! This is where something 
ike the Smart Home Herb Garden from Oscar Prom at 
Deeplocal comes in handy. 
“The herb garden was built for Google I/O 2019 


[ f you’ve ever grown herbs in your kitchen, you 


A Each herb can be maintained individually, so you won't 


to showcase the Smart Home API and some newly overwater one plant and underwater another 
cerhvareieam lead released traits on the IoT platform,” Oscar explains. 
at Deeplocal. He “We released it as a DIY project to encourage Automated gardens are all the rage now — we’ve 
plans, develops, developers to use it as a jumping off point for their had farm robots, hydroponics, and aquaponics 
urea own Smart Home projects.” in The MagPi - so scaling it down to a small herb 
stack and cloud garden seems like a logical next step. So, when 
software systems. Deeplocal were asked to build a Smart Home 


project using voice control, it’s the route they 


magpi.cc/pNpRxP 
decided to take. 


M Three potted herbs sit 
under a beam that has 
lights and water misters @ 


Ns Voice-activated care 


A 
i —— ——— The system is deceptively simple. Three potted 


Warning! 
Mains electricity 


herbs sit under a beam that has lights and water 
misters. There’s also a humidifier on the tray that 


[nis project uses mains the plants sit on, and each plant can rotate to make 
power. Be careful if you A Testing the mister before embedding it in a shelf is a good P . “a Be 
plan to recreate it idea whatever project you're working on for easier pruning and watering hard-to-reach 
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These decorative 
stones hide humidifiers 


and turntables for 
the plants 


The bar that goes 
over each plant 
provides light and 
water when required 


Each plant is monitored by the 

system to make sure it’s getting 

enough water and sunlight The three herbs 
grown were basil, 
parsley, and mint 


The team 
unfortunately 
no longer have 
the garden 


It does have voice 
control, but is 
otherwise fully 
automated 


The system 
is written in 
JavaScript 


Find full build 
instructions here: 
magpi.cc/fCPqeP 


The Smart Herb 
Garden was created 
for Google I/O 

2019 - here it is on 
display there! 
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P Astore-bought 
humidifier needs to 
be modified to work 
in the system 


V The humidifiers 
release spooky 
water vapour from 
the rocks 
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M |t gutomatically rotates 
the plants to distribute 
Sunlight evenly 


areas. There’s even a special function that lets you 
‘spotlight’ a specific plant if you want to really 
show off your prize parsley. 

“Raspberry Pi provides a familiar and inexpensive 
platform to get any project off the ground,” Oscar 
tells us. “We needed something low-power and 
internet-connected that could control custom 
hardware, and there is no dev board that hits that 
sweet spot better than a Raspberry Pi.” 


No growing pains 

After having tried our own hand at growing herbs 
in the past, we had to ask about the project’s 
herb-growing prowess: “It’s much better than a 
human!” asserts Oscar. “It remembers to water 
the kitchen herbs without issue and automatically 
rotates the plants to distribute sunlight evenly. We 
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Building a 
smart herb garden 


Awater pump system needs to be properly 
put together to provide water for the herbs. 
The humidifier system is handled by an off-the- 
shelf humidifier controlled by a relay, so it doesn't 
use this system. 


120VAC 


A It looks a little 
complicated, but it's 
not too bad really 


<4 Don't make our 
mistake: make sure 
to prune your herbs! 


The pots use magnets to snap to a custom 
rotation device that is set up in three sections 
along the bottom of the herb garden. Each of the 
rotators is controlled by a simple electric motor, and 
they use some 3D-printed parts. 


can even increase the brightness of the grow lights 
on our cloudy Pittsburgh days (read: often).” 

This isn’t Deeplocal’s first rodeo with Raspberry 
Pi either, and it seems like the team specialise in 
amazing home improvement projects. 


ics 


We’ve built a [Raspberry Pi- powered], voice- 
controlled drink mixer and an all-in-one button 
that starts Netflix, turns off your lights, and orders 
takeout,” Oscar says. “Not to mention, a lot of our 
prototypes are built on top of Raspberry Pi boards 
because we can iterate so quickly.” 

While the herbs in their garden grew well, they 
never got to use them in a meal. Maybe next time. 1] 


Lights are attached and can have their 
brightness controlled so that they give the 
perfect amount of light to the plants. This project 
uses white LEDs, although grow bulbs are more 
standard practice. 
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Marvin Go-Kart 


Mark Cantrill's new mode of transport suits his go-kart-loving 


daughters to a tee, as David Crookes discovers 


opposite ends of the sporting spectrum, 
but when Mark Cantrill swung by an ageing 
electric golf trolley, it set the wheels in motion for 
a rather unique idea. 
Having originally considered using Raspberry 
Pi to control the trolley and eventually turn it into 


G olf and go-karting would appear to be at 


Mark a Dalek or a rough-terrain garden explorer fitted 

Cantrill with a camera, he began to ponder how it could 
make his life a bit easier. 

An electronics “T thought I’d use it to power a go-kart and 

engineer, husband, f 3 ; 

and fatherof:bwo save my back from dragging my kids around the 

who is usually garden,” he laughs. But first he had to figure how 

ound running the to get Raspberry Pi to control the trolley, so, after 

Cotswold Raspberry fitti DV batt heb fo loolkat 

Jam's MicroPiNoon itting a new 12V car battery, he began to look a 

arena. He's known the device’s radio-controlled mode with a view to 

or creating the reverse-engineering it. 

PiZ-Moto motor 

driver for Raspberry 

Pi Zero and an FPGA Go, go-kart 

board for the original “The trolley could be made to go forwards, 

Raspberry Pi. backwards, left, and right using a five-button 

@AstroDesignsLtd remote control, and the fifth button would bring 


The robot features the 
golf trolley's original 
motor controller, which 
has a handy on-board 
5V power supply 


Mark is building a new 
casing for the towing 
robot, with an extra 
wheel fitted beneath 
the base 
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it toa stop,” Mark explains. He soon noted that 
the radio receiver was a plug-in option, witha 
seven-pin connector joining it to the main speed- 
controller micro. 

“1 thought it would be possible to remove the 
radio receiver and replace it with Raspberry Pi,” 
he says. “Since the motor controller on the golf 
trolley was 5V, the 3.3V outputs from Raspberry Pi 
needed level-shifting, which I achieved by using 
a 2N2222 NPN transistor. Five transistor-based 
inverting level shifters were quickly assembled 
onto a ProtoZero board.” 

At this point, Mark began to write the software 
and he was able to call upon his experience of 
running MicroPiNoon robots at the Cotswold 
Raspberry Jam. “The golf trolley had two motors, 
two wheels, and a front stabiliser, so it was 
essentially very similar to the MicroPiNoon robots, 
just a bit bigger. 

“All I needed to do was replace the functions 
that usually control the Edukit 3-compatible PiZ- 
Moto pHAT with functions to drive the 5-bit output 


Raspberry Pi is 
connected toa 
ProtoZero on which 
five-transistor-based 
inverting level shifters 
were assembled 


ees 


‘ted / . 


| thought I'd save my back 
from dragging my kids 
ground the garden 


that goes to the golf trolley’s motor controller via 
the level shifter. I was able to reuse my existing 
code to do this.” 


Be in control 

Mark took the enhanced prototype golf trolley 
to Raspberry Fields last year and allowed people 
to play around with it. At this point, the trolley 
wasn’t attached to a go-kart, but it highlighted a 
particular problem: the PlayStation 3 controller 
Mark was using — a model made by Rock Candy - 


would shut down after a few minutes of no activity. 


The golf trolley's radio receiver was reverse-engineered 
so Marvin could replicate the instructions it issues using 
Raspberry Pi instead 


Fe we di : 
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Han 


Jessica and Ruth love 
being pulled around the 
garden by Marvin, with dad 
Mark at the controls 


“Tt would then search for something to 
communicate with, but this wouldn’t necessarily 
be the last thing it was talking to,” Mark says. “It 
meant that it would sometimes find another robot 
— on one occasion it hooked up with a device called 
X-Bot, sending it crashing off a table.” 

The controller problem remains unresolved 
and Mark says he also needs to work on better 
acceleration controls. “I’m also working out how to 
get the controller to slow down gradually instead of 
stopping abruptly,” he adds. But when everything 
is working well, Marvin is a joy. The robot can 
whizz around the garden with a go-kart in tow, to 
the great excitement of his daughters. “They love 
it,” Mark concludes. 


P Mark is looking to 
securely mount the 
motor controller and 
Raspberry Pi to the 
towing robot and 
make the casing 
more weather-proof 


Marvin Go-Kart 


Marvin has a 
Raspberry Pi 
Model B+ 


A PlayStation 3 
gamepad provides 
wireless control 


The interface was 
built ona 
ProtoZero board 


The project cost 
about £110 


Mark tried without 
joy to remotely 
control the 
trolley's horn 
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A standard webcam 
is used to monitor 
the driver's eyes 


Luis Oliver 
and Andre 
Hernandez 


Two Mexico City- 
based makers. Luis 
is also a founder 
of blankit.com.mx 
- aiming to create 
a comprehensive 
loT platform 

for healthcare 
applications. 


The camera can 
be mounted in 
various positions, 
but should point 
at the driver's face 
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road accident after falling asleep at the 

wheel prompted Luis Oliver, and his 

friend Andre Hernandez, to develop 
a driver drowsiness monitoring system that 
can work in any vehicle. “Luckily it was a small 
accident,” Luis tells us, “but I realised that the 
next time it happened, it could be my last. So I 
decided to try and create a smarter solution than 
just a cup of coffee.” 


¥ 


Intelligent Drowsiness Monitor 


The camera is connected 
to a Raspberry Pi and other 
electronics in this case 


A speaker in the case emits a loud 
beeping noise to wake the driver 


A clever device that detects if you are sleepy behind the wheel, 
and gives you a loud wake-up call. Nicola King finds out more 


Following some initial research, Luis turned his 
attention to creating a physical device that could 
detect if a driver was falling asleep. “I came to the 
resolution to create a system that continuously 
monitors my conscious state.” Once he’d settled 
on the concept for the system, he began to 
research which hardware and software he was 
going to use. “The obvious choice was a Raspberry 
Pi as the main processor of my project, as it needed 
to be small and portable.” 


Wake up sleepy-head! 

Over the next couple of weeks, and following a 
number of successful tests in front of computers 
and eventually in vehicles, the Intelligent 
Drowsiness Monitor was born, incorporating a 
crash notification system, but how does it work 
exactly? Luis and Andre describe the monitor 

as a kind of ‘guardian angel’. Luis elaborates, 
“Tt is continuously monitoring your face at all 
times. If it notices that you are falling asleep, at 
that time it will emit a loud sound - which, we 
can assure you, will wake you up. However, if an 
accident nevertheless happens, the monitor will 
send an alert at that time to family or friends 


V Andre tests out the system by closing 
his eyes - note that for safety reasons, 
he's parked in his driveway! 


7 | personally see great 
potential for this type of 
technology to be included 
in all cars @ 


and to emergency services, if the user opts to use 
that functionality.” 

Luis says the most complicated part of the 
design was installing the OpenCV computer vision 
library (used to analyse the camera images) on 
Raspberry Pi: “You have to perform a complete 
build to make it work correctly.” Details can be 
found on the project’s Hackster.io page 
(magpi.cc/ckywoP). “After that, we proceeded to 
develop the algorithm to monitor drowsiness by 
vision and notifications in real time through GSM.” 

Luis and Andre had to debug the vision 
algorithm regularly, and tweak the sensitivity 
parameters of the monitor, but it was important 
that “this process was carried out exhaustively 
so that the test on the car [would] work without 
problems [or] errors,” says Luis. 


In the driving seat 
While detecting driver behaviours/tiredness is not 
a new concept, as some luxury car manufacturers 


A ARaspberry Pi, powered by a battery pack, is connected to the 
camera, speaker, an accelerometer, and mobile data dongle 


do already have similar systems in some of 

their vehicles, Luis and Andre think that such 
technology should be open to all, as Luis tells 

us: “I personally see great potential for this type 
of technology to be included in all cars, not just 
luxury cars — it is an economic system that can be 
easily installed, does not consume much energy, 
and takes care of you at all times.” 

He adds, “In fact, we are in talks with 
manufacturers in our country... We will try to 
improve the prototype with the new Raspberry Pi, 
and thus be able to make a proper pitch, and see 
if they would be interested in working with us to 
develop a pilot or some test on their vehicles.” 

We certainly wish the pair luck with that 
endeavour. Safety on the world’s roads is such 
an important issue, and anything that helps to 
improve our protection can only be a good thing. H 
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> OpenCV is used to 


analyse the camera 
image and detect 
closed eyes 


> If the driver's eyes 


are closed for three 
seconds, an audible 
alert is triggered 


> AVMA204 


accelerometer 
will detect a 
possible collision... 


ln which case, 
a crash alert is 
sent to family 
or emergency 
services 


> The notification 


system uses a 
Soracom mobile 
data dongle and 
AWS loT 
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smart 
Window Fan 


When you need to keep your home cool during the summer months, a smart 
window fan could be just the thing. Phil King enjoys a breath of fresh air 


Ishmael 
Vargas 


From the 
Chicagoland area, 
Ishmael has a 
background in 
industrial electronics 
and electrical 
systems. He likes 

to experiment with 
Raspberry Pi 

and Arduino. 
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ummer days, and nights, can be 
S uncomfortably hot and humid in the 
Chicago area. As the sun goes down, the 

outside temperature drops, but homes may remain 
hot. This is where a window fan comes in useful, 
blowing cooler air into the house. Last summer, 
Ishmael Vargas was using a small window fan 
upstairs and, after turning it on in the afternoon, he 
found he had to get up in the middle of the night to 
turn it off. “That is when I thought there must be 
a better way to control this fan,” he recalls, “and I 
started putting this project together.” 

As he was already using a DHT22 temperature 
and humidity sensor for another project, he opted 
to use that, connected to a Raspberry Pi Zero 
running a Python program, to monitor the room 
temperature. This is then compared with the 
external temperature; if the latter is cooler, the 
window fan is turned on via a smart WiFi power 
plug (TP-Link HS100) — a much simpler method 
than wiring the fan up to a relay. 


Mm \f the external temperature is cooler than 
that inside, the window fan is turned on 
via ag smart WiFi power plug @ 


Weather report 

To keep things simple, Ishmael opted to source 
the outdoor temperature from Weather.com 
(The Weather Channel) using the pywapi Python 
library, rather than wiring up an external sensor. 
“The temperature provided by Weather.com as 
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192.168.43.82 


11:41:33 


Inside 
Outside 


Humidity 37 


CHICAGO/MIDWAY, IL, US 


A Viewable via VNC on a smartphone, the program window 
features temperature data and control buttons 


compared to the temperature in my car could 
differentiate by one or two degrees. This is close 
enough for this project,” he explains. “In other 
parts of the world or rural areas where they do not 
have as many weather stations, an outdoor sensor 
might be required.” 

One issue he discovered was that in the early 
morning, the fan could end up blowing warm air 
into the house. “Depending on the size of the 
fan, the size of the room, and house materials, 
the inside temperature might never be as cool as 
outside,” he says. “For example, if the temperature 
outside is 65°F (18°C), the temperature inside might 
only drop to 67°F (19.5°C) through the night. As the 
temperature outside starts to climb, you want to 
keep the fan off.” This resulted in him adding an 
‘inhibit’ mode to turn the fan off at 6am. 


Remote control 
Rather than having the fan program run 
automatically on bootup, Ishmael opted to 


> The project took 
about two weeks 
to complete 


> The DHT22 sensor 
is measured every 
eight seconds 


> Weather information 
is retrieved every 
40 seconds 


>» ABash script is 

used to turn the 
smart plug on 

Asmart WiFi socket and off 

is used to turn the 

window fan on and off > Ishmaelis 
working on an 
FPV WiFi paintball 
turret project 


start and control it manually via an Android 
smartphone. The latter runs the VNC Viewer 
app, enabling remote access to Raspberry Pi’s 
desktop, on which there is a shortcut to start 
the fan application; this then displays a Pygame 
window with temperature information and 
control buttons. 

“The fan application has two buttons to change 
the [desired temperature] set-point up or down,” 
reveals Ishmael. “Also, the button on the upper 
right is to close the application and return to the 
desktop.” His aim is to have more than one project 
running on his Raspberry Pi, and have a desktop 
shortcut for each application. 

While the original project used a single fan, 
he has since modified it to add another. “I have 
been reading that two fans are required for best 
performance,” he says. “One to blow in and 
another to blow out.” 

This certainly is a cool project, in more than one 
way. If you’d like to have a go at building a similar 
system, you can read Ishmael’s Hackster guide 
(magpi.cc/kzibLu) and check out his GitHub Tepo A The DHT22 sensor is connected to power, ground, and GPIO 4 
(magpi.cc/zAzGZS) for the code. H pins on a Raspberry Pi Zero - a 10kQ resistor is recommended 


The indoor temperature is 
read by a DHT22 sensor; if 
it's cooler outside, the fan 
is turned on 
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PIC-20 


Retro enthusiast Adam Sommerfield revives broken computers by allowing their original 
keyboards to be used in combination with Raspberry Pi, as David Crookes explains 


Adam 
Sommerfield 


Married with 

two young sons, 
Adam runs a small 
YouTube channel 
called Banana 
Retro, and he 
oversees Facebook 
groups dedicated 
to Raspberry Pi and 
retro emulation. 


magpi.cc/soPCYo 


A couple of USB 
ports are viewable 
from the side of the 
machine. The holes 
could be filled for a 
neater finish 
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hen Adam Sommerfield was five 
W years old, his parents bought him 

a Commodore VIC-20 computer. 
Released in 1981, it was very popular at the 
time — the first to sell a million units — but 
Adam’s machine didn’t actually work, so his dad 
took it back and swapped it for a Commodore 
Plus/4 instead. 

Ever since that childhood incident, Adam had 
wondered what that VIC-20 would have been like 
to use. He even had a game for it, Crazy Cavey, 
which he had never played. While online one 
day, he came across a device that would allow 
old machines to be used as a USB Keyboard, so 
he hatched a plan involving a broken VIC-20 and 
Raspberry Pi. 

Coming across an inexpensive, non-working 
VIC-20 on eBay sold for spares or repairs, he 
sought to bring it back to life by emulating the 
original computer. Knowing he could do this 
on Raspberry Pi using the emulation software 
Combian64, written by Carmelo Maiolino, he 
got to work. 

“T removed all the internal parts from the 
VIC-20 other than the keyboard itself,” recalls 
Adam. “I then stripped the keyboard down and 
gave it a good clean using an air duster and 
cleaning fluid. From there, it was a matter of 


A When PIC-20 is connected to a monitor, it looks and behaves 
like an original VIC-20 from the 1980s 


figuring where Raspberry Pi and the necessary 
cables needed to go.” 


Converting the keyboard 

A crucial part of the project was a custom USB 
keyboard adapter — to allow the VIC-20 keyboard to 
be plugged into Raspberry Pi. Adam had seen that 
David Cullen, of Tynemouth Computers, creates 
and sells a number of these device for various 

retro computers. “That took care of the hard 
work,” Adam says. With the adapter attached to 

the VIC-20 keyboard, it was possible to connect it to 
Raspberry Pi. “I looked to place its ports as close to 
the casing’s holes as possible, but these were spread 
across the back and side of the casing so I used short 
male-to-female leads instead, giving access to 
HDMI, USB power, and the microSD card slot,” he 
explains. “I also used a four-port USB hub to allow 
components such as joysticks to be inserted.” 

The USB adapter, USB hub, and Raspberry Pi 
were fixed with nylon supports and fasteners to act 
as legs, giving space between them and the base 
of the case. Some of the cables were also secured 
using hot glue. “This can get a bit of a mixed 


2 


PROJECT SHOWCA‘ 


The VIC-20's keyboard easily unplugs 
from its motherboard, allowing 


it to be connected to Tynemouth 
Software’s USB keyboard adapter 


ae 7 
f 
| 


Tete 


~~ 


ATA 
(\| 

ee 3 
Combian64 is installed on 


Raspberry Pi and cables run : Vv 
from it, allowing for accessible ° 
HDMI and USB connections, 


as well as a power switch 4 
TRY The USB hub is connected to 


Raspberry Pi and a wire runs from 
this into the keyboard adapter 


> Adam looks out for 
broken computers 
to revive 


> Raspberry Pi is 


used to emulate 
old systems 


M | like to think I've saved 
dg micro from heading to 
the skip @ 


» Aretro conversion 
can cost around 
£145 overall 


> The USB keyboard 
adapter kit 
costs $60: 
magpi.cc/cepafK 


reaction sometimes, but if you’re careful then it 
can work just fine.” 


Installing the software 

With everything fitted neatly inside the case, it 
was a matter of closing up and booting. “Having 
Combian64 installed on Raspberry Pi helps to 


» Adam gives away 
any spare parts 
he strips 


recreate the original VIC-20 as closely as possible ” A The USB keyboard adapter also allows a retro computer to be 
if : iy used as a regular PC keyboard: a mode button converts keys, 
Adam says. The build also required no programming. so the Commodore key becomes the Windows key, for instance 


“By using Combian64, it’s possible to build a 
Commodore computer that gives near-instant boot. | Commodore 16, as well as an Apple Macintosh, 


There is no on-screen boot text either so, if you Apple Lisa, Acorn Electron, Sinclair QL, and ZX81. 
didn’t know better, it could be the original thing.” He’s even worked on using Raspberry Pi to revive 
The VIC-20 is not his only retro project. Using a broken Commodore Plus/4 - the machine that, 
other emulators and different USB keyboard inadvertently, became his first computer. “I like to 
adapters, he’s converted a Commodore 64 and think I’ve saved a micro from heading to the skip.” 
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Raspberry Pi Case 

Protect your Raspberry Pi 
from spills and dust with 

a chic case. Official Raspberry 
Pi cases come in red/white and grey/ 
black, but there are plenty of cases available 

from other companies too. If you’ll be building electronics 
projects, look for a case that gives you easy access to the GPIO. 


magpi.cc/YNVYfF 


Raspberry Pi Camera Module V2 
You can plug a Raspberry Pi Camera 
Module into a dedicated connector on 
Raspberry Pi and it has an 8-megapixel 
sensor. It works with Raspberry Pi 

1, 2, 3, and 4. Shoot a movie in high 
definition, get close to nature with a 
bird-box cam, or secure your home. 


magpi.cc/camera 


CamJam Edukit #3 

With its easy control of electronic 
circuits, Raspberry Pi is ideal for 
robots. This kit contains everything 
needed to build your first robot, 
including a motor controller board, 
sensors, and wheels. Make a chassis from 
Lego, 3D-print one, or even use the box. 


magpi.cc/RhpjZh en" 


Sean McManus 


Sense HAT 
HATs (short for Hardware Attached on Top) 
are accessories that plug onto a Raspberry 
Pi’s GPIO pins. The Sense HAT includes a 
colourful 8x8 grid of LEDs and a five-button 
joystick. It’s packed with sensors: gyroscope, 
accelerometer, barometric pressure sensor, 
magnetometer, thermometer, and humidity 
sensor. It’s a portable science lab! 


magpi.cc/sense-hat 


Fan SHIM 
Raspberry Pi 4 is 

a bit more power 
hungry than 

earlier models. If you 
find it runs hot for 
your application, 

try using the Fan 
SHIM. It provides a 
software-controllable 
fan to cool a Raspberry 

Pi. You can use it together with HATs, by 
fitting a booster header to lift them above 
the fan. Read more in our review on page 76. 


magpi.cc/qZYBWd 


Meet Raspbian with Desktop 


01 Click the Raspberry Pi 
logo to open the applications 
menu. This is where you’ ll 
find the software that’s pre- 
installed in Raspbian, and 
anything else you add later. 


O2 Click the globe for quick 
access to the Chromium 
web browser. 


O3 Click the folders to 
open the File Manager. You 
can use it to find, move, 
copy, and delete files on 


your storage devices. Why 
not explore the Linux 
file system? 


O4 Find the Terminal here. 
It gives you powerful tools 
for managing your files and 
devices, and the command 
line is often the quickest way 
to get things done. 


05 Volume control. Right- hover the mouse pointer wirelessly control your store your files in the 
click to select audio output. over the icon to see your Raspberry Pi device. /home/pi folder. 

Raspberry Pi’s IP address. 
O6 WiFi options. Turn O8 File Manager. Use the O9 With basic, scientific, 
WiFi on and off, and switch 07 Manage Bluetooth hierarchical browser on and paper modes, this 
networks here. If the icon connections. You can use the left or the Go menu to calculator is handy. Find it 
is blue like this, you’re Bluetooth devices such find devices connected to in the Accessories section of 
connected. You can also as keyboards and mice to Raspberry Pi. You should the applications menu. 
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Discover some of the software 
that comes with Raspbian, and 
find out how to install more 


installed software (which depends on 

which version you install), so you can start 
working, learning, and making things straight 
away. Ranging from productivity suites to games, 
you'll find a well-curated collection of software is 
just a click away, in the applications menu. There 
are lots more packages to browse and install, too. 


2 aspbian comes with a selection of pre- 


' LibreOffice Writer | OFFICE 
42) Nocomputer is complete without a word 
processor. LibreOffice Writer has all the 
font and formatting options you would expect, and 
has basic compatibility with Microsoft Word. 


SN LibreOffice Calc | oFFice 
Work out your budgets with this 
spreadsheet package. If you’re familiar 
with Microsoft Excel, you’ll feel at home here. 


LibreOffice Calc can open and use typical Excel files. 


NS LibreOffice Impress | OFFICE 
E If you’re presenting to a room of people, 
don’t panic: Impress has your back. Use 


it to craft and display your slide deck. It’s largely 
compatible with Microsoft PowerPoint. 


= Chromium | INTERNET 
. Chromium is the open-source version 
of Google Chrome. The default search 
engine in Raspbian is Duck Duck Go, which 
promises not to track you online. 


: Claws Mail | INTERNET 
Oh, Send and receive email. The setup wizard 
helps you add your email account, and the 
streamlined interface shows you your mailboxes, 
message list, and a preview of the selected message. 


cj 


a VLC | SOUND & VIDEO 
Listen to music while you’ re coding using 
VLC, a fully featured media player for 
music and video. It can play digital files, streams, 
and physical media such as CDs and DVDs. 


Minecraft Pi | GAMES 
MINECRAFY 
eer We call it a game, but it’s more a way 


of life. With Minecraft Pi, you can build 
things in Creative mode, and write programs to 
change the (game) world. 


a Python Games | GAMES 
Pa These tea-break games are fun, but 
theyre also great Python demos. Find the 
code in the /usr/share/python_games folder, and 
open it in a Python editor to see how it works. 


SmartSim | PROGRAMMING 
{S| Experiment with designing and testing 

digital logic circuits. You can develop 
custom components, and then incorporate them 


into other circuits. Download examples and read 
tutorials at smartsim.org.uk. 


Sense HAT Emulator 
cy PROGRAMMING 

This emulator features on-screen 
controls to simulate temperature, pressure, 


humidity, and device position changes. A great way 
to try out the Sense HAT before you buy one! 


Updating your software 


Linux software comes in packages, 
which are compressed archives 
that you can download. A package 
manager is used to find and install 
them, including any other software 
they need to work. 
Use Add/Remove Software to 
update your packages. From the 
menu, choose Preferences > Add / Remove Software. Click on 
Options and Check for Updates. 
You can also update from Terminal. In Raspbian, the package 
manager is called APT. Updating all the software from the Terminal 


is a two-step process. First, enter GUfefeMeyeler iam xecigs in the 


Terminal to update the cache of available software. Then enter 

to update the software installed on Raspberry 
Pi. You’ll be told what changes will be made and asked to confirm by 
typing Y and pressing ENTER. 


Installing software 


The easiest way to manage software is to use the Add / Remove 
Software tool in the Preferences part of the applications menu. It 
provides a visual front-end for the package manager. 

You can click a category on the left to browse applications, or 
enter a keyword in the search box in the top-left to look fora 
particular application. Choose the applications you want to install 
by ticking the box beside them. Some packages require other 
packages to work properly, but the tool will take care of that for 
you. To remove an application, untick its box. When you’ve made 
your choices, click OK to install or remove your software. 
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If your Raspberry Pi is in a tree photographing nature, you don't 


want to climb up there just to update it. Log in remotely and take control 


connect to your Raspberry Pi: Secure Shell 

(SSH) and Virtual Network Computing 
(VNC). Before you can use them, they need to be 
switched on in the Raspberry Pi Configuration 
settings. To do so, click the Interfaces tab, then 
enable SSH and/or VNC. 

Both approaches require you to know the IP 
address of your Raspberry Pi device. To find out, 
click the Terminal icon on the taskbar, and enter 
ifconfig at the prompt. It will show you all your 
network connections. You’re looking for an IP 
address, which will be four numbers with a dot 
between them, like 198.51.100.0. You’ll find it 
beside ‘inet’, in the details for wlano if you’re using 
WiFi or in the etho summary if you’re plugged in to 
the network. 


T here are two technologies you can use to 


Using SSH 

SSH enables you to use the command line on 

your Raspberry Pi remotely, so it’s very handy for 
installing software and fixing configuration files. 
You can’t use SSH to run any applications that need 
the graphical desktop, though. 


System Interfaces | Performance | Localisation 
Camera Enabled ¢ Disabled 
SSH ¢ Enabled Disabled 

Cc © |Enabled Disabled 
SPI Enabled ©) Disabled 
2c Enabled On?) ed 
Serial Port Enabled ¢) Disabled 
Serial Console 
1-Wire Enabled ° 


Cancel OK 


A Enable SSH and VNC before you try to use them 


The software for SSH is pre-installed on 
Linux, macOS, and Windows 10. Start by opening 
the command line. On a Mac, find it by typing 
‘Terminal into the Spotlight search. On Windows 
10, Use +R to open the Run dialog box, then 
type in cmd. 

Once you’ re in the command line, enter 
ssh pi@198.51.10@.@, but replace the numbers 
with the IP address of your own Raspberry Pi 
device. The ‘pi’ bit is your username. 


M@ SSH enables you to use 
the command line on your 
Raspberry Pi remotely, so 
it's very handy 


The first time you connect to a device using SSH, 
you’ ll see a warning that shows the ECDSA key 
for the device you’ re trying to connect to. You can 
(if you wish) validate that this is correct by using 
ssh-keygen -1 -f /etc/ssh/ssh_host_ecdsa_key.pub 
in the Raspberry Pi Terminal. But it’s usually OK to 
just type in yes and then press ENTER to confirm 
you want to connect. 

You’ll be asked to enter the password for your 
Raspberry Pi device. You won’t see the cursor move 
while you do this, so type on regardless. When you 
press ENTER, you’re in! You’ll see a Linux welcome 
message, the date and time of your last login, and 
then the Raspbian command prompt, waiting for 
instructions. When you’ve finished, enter exit to 
eave the SSH session. 

If you’re using an earlier version of Windows, 
download PuTTY from putty.org. Enter your 
Raspberry Pi’s IP address in the Host Name box, and 
click Open. Again, you’ll see a warning if this is your 
first connection, which you can safely dismiss. Log 
in as pi, and enter your password. Raspberry Pi is 
now at your command! 


A Using VNC Viewer to manage Raspberry Pi from an iPad 


Using VNC 
Virtual Network Computing (VNC) enables you to 
remotely access the Raspberry Pi desktop, so you 
can manage files and run software using it. Some 
people use VNC to share their keyboard, mouse, and 
monitor between a PC and Raspberry Pi. 
Raspbian includes VNC Server, which runs 
automatically in the background if you’ve enabled it 
in your settings. You’1l need to download and install 
VNC Viewer (magpi.cc/FuGnye) on the device you 
want to use to control Raspberry Pi. VNC Viewer is 
available for Windows, macOS, and Linux. There are 
also Android and iOS apps, so you can use VNC to 
control Raspberry Pi from a mobile device, although 
it’s rather fiddly without a real mouse and keyboard. 
Optionally, by creating a RealVNC account and 
registering your Raspberry Pi, you can then access it 
from anywhere in the world using VNC Viewer. 
When you start VNC Viewer, it’1l ask you to enter 
a VNC Server address. This is the IP address you 
noted when you ran ifconfig on your Raspberry Pi. 
The first time you connect to a device, VNC 
Viewer warns you that it has no record of 
connecting to this device before, and shows you the 
device’s signature and identification catchphrase. 
To verify you’ re connecting to the correct device, 
click the VNC icon on the right of the taskbar in 
Raspbian to see your device’s details. 
VNC Viewer prompts you to enter the username 
and password for the device you’re connecting to. 
You’ll then see your Raspbian desktop in the VNC 
Viewer window. You can now use your keyboard 
and mouse (or touchscreen on a mobile device) 
to control the Raspbian desktop, including using 
programs installed on Raspberry Pi. 


ve] VNC Viewer - File Transfer 
To send files to VNC Server, click the Send files button, below 


To fetch files from VNC Server, navigate to the VNC Server icon in the notification tray or 
status bar and select File Transfer from its shortcut menu. 


To change where files fetched to this computer are saved, use the Fetch files to drop-down 
list, below. 


Send files... Fetch files to: J Desktop 


At the top of VNC Viewer in the middle is a tiny 
toolbar. The File Transfer option enables you to easily 
copy files to Raspberry Pi. 


Connectivity Security 


identity check Md 
c jo Literng VNC Viewer 
Licensing 
Check for epaates 
— Stop VNC Server 
Hide 
Concnenease 
» Other ways to connect 


Authentication 


Send files from Raspberry Pi using the File Transfer 
option in VNC Server in Raspbian. Use the three-bars 
menu (top-right) to find it. 


4:43 
Hi there! Who's connected right now? 
just me, buddy 
2019 14:44 
Did you manage to fix that bug? 
yes and no 
14:45 
what does that mean? 


well, | fixed the bug just fine. But the fix caused 
another one. So I'm trying to sort that out now. 


14:49 
hello 
Wed 10 Jul 2 14:51 


pi: who just joined? 


Use the toolbar in VNC Viewer to start a chat 
session with anyone using the server (Raspberry Pi 
device) and anyone else connected to it remotely. 
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Raspberry Pi comes with everything 
you need to start programming 


in for a treat. Raspbian comes with several 

integrated development environments (IDEs) 
you can use to write your own programs, supporting 
languages that are friendly to use, and fun to tinker 
with. If you’re a veteran coder, you’1l find powerful 
IDEs are included to help you be productive, too. 


[ f you’ve never programmed before, you’re 


Scratch 2 

LaNcuAGE: SCRATCH 

With its friendly drag-and-drop commands and 

a library of sprites and sound effects, Scratch 
makes it simple to get started with coding. By 
minimising typing, and guiding you to sensible 
block combinations, it helps you to avoid common 
mistakes. Don’t be fooled by its accessibility, 
though: it’s a fully-fledged programming 
language, with plenty of potential. 


Thonny 

LaNcuace: PYTHON 

Python is one of the most popular languages on 
Raspberry Pi, and Thonny is our favourite way to 
edit it. In a single window it shows you your code, 
the shell, and your data (variables), so you can easily 
see what’s going on and fix any bugs that creep in. 


Sonic Pi i 
ancuace: SONIC PI Pas 
Learn how to - = 
compose and perform si 
music with code! eee eile et 


synths, samples, and 
effects that you can 
control by writing programs using a language based 
on Ruby. You can develop and modify programs 
while the music plays, to perform live concerts or 
improvise at home. 


Node-RED 

tancuace: JAVASCRIPT/NODE-RED 

Node-RED enables you to use a flowchart to program 
data flows for Internet of Things applications on 
Raspberry Pi. It uses JavaScript, the language of the 
web. Run the Node-RED console in Raspbian and 
then visit http://localhost:1880 in your browser to 
program it. For help, see nodered.org. 


Greenfoot 
LaNcuacE: JAVA 

Java is one of the 
world’s most popular 
programming 
languages. Greenfoot 
makes it easier to 
learn, by providing a friendly environment for 
building simple games. The editor incorporates 

a game world, and you add Java code to image 
objects to control their interactions. Find out more 
at greenfoot.org. 


Geany 

LaNcuaceE: LOTS! 

If you’re looking for a lightweight but powerful 
IDE, try Geany. It supports many languages, 
including HTML, C, Java, PHP, JavaScript, and Perl. 
Its code auto-completion and syntax highlighting 
can help you code faster, and reduce errors. Our 
favourite feature? Code folding, used to show or 
hide logical chunks of code in a long program. 


THE OFFiciay 
The Official Raspberry ane Pj 
Pj Beginner's Guide Hon ye vg 


Available to buy in print and as a free PDF| 
this book shows you how to set up Raspberry 
Pi, and gets you started with programming 
it in Scratch and Python. It also covers the 
Sense HAT and Raspberry Pi Camera Module, 
with code examples you can build and tailor. 


magpi.cc/BGbook 


GPIO Zero Documentation 

See how easy it is to start programming your 
own electronics projects for Raspberry Pi. 
The documentation for GPIO Zero shows you 
how to connect up sensors, LEDs, motors, 
and more. With a bag of cheap components, 
you can start building your first circuits. 


rpf.io/gpiozero 


Hacking and 

Making in Minecraft 

Minecraft on Raspberry Piis a 
great way into the world of coding. 
This book, another in The MagPi 
Essentials series, shows you how to 
shape the world with Python code, 
use a connected LED as a treasure 
sensor, and use Sonic Pi and Node- 
RED together with Minecraft. 


magpi.cc/MCbook 


Conquer the Command Line 

We publish a series of short books called The 
MagPi Essentials, and this one explains the 
Terminal, including using it for connecting 
disks, compiling software, and backing up. You 
can download all the books in the series, and 
past issues of The MagPi, at magpi.cc/issues. 


magpi.cc/CLIbook ll 


Official Raspberry Pi 

Documentation 

The documentation provides concise user 
guides for Linux, Minecraft, Sonic Pi, Scratch, 
and Python. It’s also the place to go for 
advice on configuring Raspberry Pi, hardware 
specifications, and remote access tips. Useful 
for both beginners and power users. 


rpf.io/docs 


Vi Raspberry Pi 


Python Games 

Go behind the scenes of the Python games that 
come pre-installed in Raspbian with Al Sweigart’s 
free online book. It explains the program code for 
seven of the games in detail, and lets you study 
another four listings yourself. 


magpi.cc/RTfkvD 
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THE OFFICIAL 


har How to use your new computer 


2nd Edition 


a 
| a me 


@ aay 


The only guide you need to 
get started with Raspberry Pi 


e Learn how to set up your Raspberry Pi, install an operating 
system, and start using it 


e Follow step-by-step guides to code your own animations and 
games, using both the Scratch and Python languages 


e Create amazing projects by connecting electronic components 
to Raspberry Pi’s GPIO pins 


£10 with worldwide delivery 
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Danny makes 
robots with his kids 
as Orionrobots 

on YouTube, and 

is the author of 
Learn Robotics 
Programming. 


orionrobots.co.uk 


> These parts are 
ready to be built into 
a lunchbox chassis 
with plastic gear 
motors and plastic 
wheels. We will go 
into more detail on 
turning a lunchbox 
into a robot 


Build a 


low-cost robot 


You want to build a robot without breaking the bank. Let's see what 
parts we need, where they fit, and how to keep the cost down 


flying drone, factory robot, or autonomous 
spacecraft, you will need common classes 
of components. We’1l discover what they are for, 
focusing on those needed for a wheeled robot. 
We’1l look at what options there are for the 
components, and how we might be able to save 
money. We’1l go through the trade-offs needed 
for these options, the tools you might need, and 
their relative difficulty. 
Any robot starts with a computer to run code, 
using sensors to collect data about the world. 
There are output systems to drive motors and 
actuators to affect the world. It needs power 
systems to get the right voltage and current to the 
right parts. The robot will need mechanical parts 
for the motors to drive, along with connecting the 
sensors and a body holding it all together. 


T o make a robot, be it a wheeled rover, 


36 | magpicc | Build a low-cost robot 


An overview of robot parts 
To make a wheeled robot, you are going to 
need some common part types to make it work: 


e Achassis or body to hold everything together. You 
will need brackets for sensors eventually, too. 

e Wheels and motors to drive them. This includes 
balance wheels or castors. 

e Amain controller to run your code: Raspberry Pi. 

e A motor controller or driver to connect your 
Raspberry Pi safely to outputs. 

e Batteries and power regulation for your 
electronics. 

e Sensors to get data from the real world, like 
distance sensors and a camera. 


Going low-cost 

To go low-cost, you going to have to bea 
little creative. This will mean substituting parts, or 
finding parts that may not be the obvious choice. 
You will be able to save by shopping around, and 
waiting for parts that will take longer to ship will 
usually reduce cost. 

Having parts pre-soldered or ready-made 
usually adds quite a lot to their cost, so be prepared 
to solder things together for the electronics, and to 
bodge or repurpose things for the body. 

Robots can be made of anything, although we’re 
not advocating it; we’ve even seen a robot made 
with vegetables for a body and wheels. 


Raspberry Pi 

The robot needs a Raspberry Pi to run your 
code. How would you save here? Well, the first 
cheapest Raspberry Pi is the one you already have! 
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TopTip & 


Get creative 
and repurpose 


Mechanical 


parts give the 

robot a real- 

world presence. 
Electronics run your code, and | Motors and 
provide inputs and outputs . sensors bridge 
from/to the mechanical world . / these worlds 


Be on the lookout 
for unused 
brackets and 
plastic shapes 
that might be 
handy to use in 
robot builds. 


Make sure it’s one with wireless LAN and a 40-pin A good first robot is the lunchbox robot. 
header if you can (Raspberry Pi3, 4, and Zero W 


models are all good choices). It's @ good compromise of saving cost 
Our favourite low-cost, and low-space, option is ' 

Raspberry Pi Zero WH (magpi.cc/zerowh). This is gn d com Dp | eXxl ty O 

the smallest model, with wireless LAN and a GPIO 

header pre-soldered to the board. Since a robot isn’t e Intermediate: Cut a chassis from wood or sheet 

often connected to the screen, the lack of DSI port material — this requires access to woodworking 

shouldn’t be a problem. If you have a Raspberry Pi tools and CAD/drawing skills. 

Zero W, then soldering pins to the GPIO header is a e Intermediate: The toy hack — one of our 

fun project (magpi.cc/soldering). personal favourite options is taking a cheap 


motorised toy and swapping its electronics fora 
Raspberry Pi and motor board. 
e Hard: The least cost for a chassis is not to have 


The chassis or body one and go for a free-form robot, strapping 
The chassis holds the robot together. It’s a motors directly to control boards and batteries. 
fundamental decision on how your robot is made. This is a lot of fun, but takes experience and 
Options for a wheeled chassis are: practice. Cable ties may be all you need to buy 
for this. 
e Easy: A laser-cut chassis — these are cheap to 
buy and easy to work with. They have space to A good first robot is option two, the lunchbox 
extend the robot. They can be flimsy and do robot. It’s a good compromise of saving cost 
break, but are the simplest option and do not and complexity, it’s fun, and has a little bit of 
require much in the way of tools and time. If you character. So that’s what we’re making here. 


go for a kit, a two-motor variant is advisable. Not 
as much fun as the lunchbox option. 
e Easy: Adapt a lunchbox. This does require a 


little measuring and drilling of holes, but is still Not reinventing the wheel 

quite an easy option in terms of construction. Drive wheels will be attached to your 

You will need to choose smaller parts to fit in motors. For a low-cost robot, two driven wheels is 
the lunchbox. a good number. 
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TopTip & 


Shop around 
more 


Prices on robot 
parts vary by up 
to ten times. Swap 
words like board 
for module, and 
robot for Arduino, 
in your searches. 


V These are some 


motor examples. 
From left to right: a 
DC motor, a plastic 
gear motor, a metal 
gear motor, anda 
servo motor 


Unless trying to make experimental robots, 
plastic wheels with rubber tyres make the best 
drive wheels and are cheap and readily available. 


e Both wheels need to be the same diameter. 

e They need good grip. 

e Axles should be aligned in the centre, and 
not slip. 


Making your own is possible, but inadvisable. 
Instead, we recommend buying plastic wheels with 
tyres (search for this phrase with ‘robot’), available 
for less than £5, and often with the motors for not 
much more. 


Castor wheel or ball 

A castor wheel, ball, or skid is mostly on 
the robot to balance it, without causing too much 
friction. You can get away with a simple bottle lid 
facing down here or, for a better cheap hack, half a 
ping-pong-ball. You can buy robot castor wheel or 
roller ball assemblies for under £2. 

The important thing is that this component does 

not introduce friction, and can easily be attached 
firmly to the robot. 


07 Types of drive motors 


What kinds of motors are there? 


e DC motors simply spin. They are cheap, but are 
easily stopped with any load. 

e Stepper motors move in ‘steps’, a fraction 
of a full turn. They are not cheap, but can be 
salvaged from old printers and scanners. 

e Servo motors can be moved to a particular 
position but not make a full revolution. They 
can be controlled directly from a Raspberry Pi. 
These can be modified for continuous rotation, 
but this can be complicated or expensive. 
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e DC gear motors combine a gearbox with a DC 
motor to drive heavier loads. They are cheap 
and easy to find. We recommend this option. 


Choosing the gear motors 

Buy motors with a gear ratio above 40:1. 
Although they’ll never match perfectly, get them 
in pairs, as motors that look similar may not have 
the same speed. 
They come in plastic and metal geared flavours. 
Metal tends to last longer but cost more. Plastic gear 
motors are cheaper, but larger and not as sturdy. In 
most of our robots, plastic motors are fine. 
9o-degree motors fit better in a limited space. 
Ensure the axles match your wheels. Adapting 
axles adds complexity and cost. 
Gear motors can be salvaged from an electronic 
toy like an RC excavator or tank. 


The motor controller 
This connects your Raspberry Pi to the 
motors. Ensure it can control DC motors. 


e Buya Raspberry Pi HAT designed for motors. 
This is more expensive than other options, but 
may have additional functionality like logic 
shifting for sensors, servo motor control, or 
power regulation. It’ll cost £15-£25. 

e ADC motor control breakout module. These 
should have two channels. The cheaper options 
tend to be based around the L298N or DRV8833 
chips, good enough for our purposes. Should be 
under £8. A simple and reliable option. 

e Someone with more electronics knowledge could 
construct their own H-bridges, but this probably 
won’t cost less than the DC motor modules. 


Power up 

Robots need power for the motors and 
electronics. A Raspberry Pi needs a smooth 5V to 
run, with upto 3A capacity. Motors introduce noise 
that could interfere with your Raspberry Pi. 


e Separate power, using a USB power bank for 
Raspberry Pi and other batteries for motors. 
Power banks can be pricey, but we’ve seen 
smaller ones given away at shows. 

e Asingle set of batteries with a regulator like 
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a UBEC (universal battery eliminator circuit). 
These can be bought to provide 5 V and more 
than 2A. A UBEC can be found for around £6. 
e LiPo/Li-ion are expensive and tricky, only 
recommended for experienced builders. 


Making sense 
For more interesting code, a robot needs 
sensors to detect things. Those that don’t require 


extra conversion will save space and a little money. 


Be prepared to solder on headers. 


An HC-SRo4P is a cheap way to measure distance. 


Line-tracking sensors let the robot follow lines. 

A camera can be used to follow lines and detect 
certain objects optically. 

An optical flow sensor looks a bit like a camera 
and lets you measure x-y movement, but cannot 
tell when you have turned. 

Motion sensors can tell you acceleration, 
rotation, and change in heading. 9DOF types are 
now around £12. 


Fasteners and wiring 
For fasteners, the ‘standoff kits’ found 
online are great; get a selection of M2, M2.5, and 
M3 including the bolts, nuts, and spacers. 
Cable ties are cheap and handy. They can tidy up 
cabling but can also strap robot parts together. 
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™ For more interesting code, 
g robot needs sensors to 
detect things @ 


Hot glue is handy for stopping things rattling 
around; however, don’t use it for load-bearing 
connections. Double-sided sticky tape, foam, and 
sticky tack can also be used this way. 

Jumper wires are used to get signals and power 
between your components. We recommend 
getting male-to-female, male-to-male, and 
female-to-female jumper cable selections (for 
breadboarding). These will connect Raspberry Pi to 
most sensors and modules. 


Tools 

A hot glue gun has already been mentioned. 
Some kind of hand drill and a way to clamp parts 
will be needed for any custom building. DO NOT 
hold a part you are drilling in another hand! 

Also useful is small screwdriver set, and 
miniature spanners for fastening parts. We 
recommend needlenose pliers, side cutters, a 
multimeter, and a soldering iron. 

The best way to keep costs down is to borrow 
tools — if you have a local hackspace, makerspace, 
or can talk to a college about using their facilities, 
you won’t need to buy all these tools. Hl 
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<4 Aselection of motor 
controllers. The 
DRV883 and L298 
are small and cheap, 
with the larger types 
having more features 
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Use SSH (Secure Shell) 
with Raspberry P1 


Remotely control your Raspberry Pi from a PC, Linux, or Mac 
computer and transfer files using SSH. By Lucy Hattersley 


Lucy 
Hattersley 


Lucy is the editor 
of The MagPi. 

She likes retro 
gaming, building 
robots, coding, and 
making magazines 
and websites. 


magpi.cc 


[ You'll Need 


» Raspberry Pi 
» Network router 
» Raspbian OS 


» Second computer 
(Windows, macOS, 
or Linux) 


encrypted networking technology that 
enables you to manage computers from 
the command line over a network. 

SSH is handy if you want to quickly connect toa 
Raspberry Pi from a terminal window on another 
computer. It’s also ideal for lightweight distro 
installations that don’t have graphical interfaces, 
and projects that don’t have a screen (such as 
robots). It’s especially useful when creating 
Internet of Things (IoT) projects, as these may be 
embedded inside other hardware. 

We’ve already looked at VNC (Virtual Network 
Computing) — back in issue 71, magpi.cc/71 — and 
Secure Shell offers a similar service. But while 
VNC shares the entire desktop, SSH works from 
the command line. 


CG SH (also known as ‘Secure Shell’) is an 


SSH also enables you to share files to, and 
from, a Raspberry Pi using SCP (secure copy) 
on the command line, or SFTP (SSH File 
Transfer Protocol). 

You don’t need to install any software to start 
using Secure Shell. Linux, macOS, and Windows 10 
have the SSH command-line application installed 
by default. 

You’ll need to use the password for your 
Raspberry Pi to log in. For security reasons, 
we strongly recommend changing the default 
password (magpi.cc/tZdxha). 

SSH uses an encrypted network, so it doesn’t 
send your password as plain text. More advanced 
users can control the encryption keys, using 
ssh-keygen. For now, we’ll look at setting up and 
using Secure Shell. 


HB pi@raspberrypi: ~ 


Filename 
< 
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Local site: C:\Users\lucyh\Desktop\ 


2 files, Total size: 39,254,781 bytes 


Server/Loc... D.. Remote file Size Pr... Status 
Queued files Failed transfers Successful transfers 


Quickconnect 


s* successful 
Remote site: /home/pi 

‘Desktop a 7 pi a 
& Downloads AS ? cache S 


File. > (Filename Fil File.. Last... f 
> < > 


7 files and 17 directories. Total size: 10,108 bytes 


a 1% Queue: empty 


A SSH is turned off by default in Raspbian and has to 
be enabled. The easiest way is to use Raspberry Pi 
Configuration Tool 


Activate SSH in Raspbian 

For security reasons, Secure Shell is 
not turned on by default in Raspbian. On your 
Raspberry Pi, choose Menu > Preferences > 
Raspberry Pi Configuration. Click on Interfaces and 
set SSH to Enabled. Click OK. You don’t need to 
restart your Raspberry Pi, and SSH will be enabled 
whenever you use that installation of Raspbian 
from that point on (be sure to have updated your 
password from the default, which is ‘raspberry’). 


Activate SSH Client in Windows 

Linux and macOS both support SSH out-of- 
the-box; skip ahead to Step 3 if you are using one 
of those operating systems. 

Windows 10 supports SSH, but you need to 
activate it. Click on Search and look for ‘Manage 
Optional Features’. Click it in Search to open the 
Settings window. 

Click ‘Add a feature’ and wait for the list of 
Optional Features to load. Scroll down the list to 
Open SSH Client (Beta). Click Install. 


Get your IP address 

Connect your Raspberry Pi to a local network. 
Use wireless LAN, or connect Raspberry Pi directly 
to a router with an Ethernet cable. Open a Terminal 
window and enter the following command: 


hostname 
You should see: 

raspberrypi 
In some circumstances you can use this host name, 
which is handy if you don’t have the IP address, but 


it’s more reliable to use the IP (internet protocol) 
address. Enter this to get your IP address: 


hostname -I 


This will return four numbers separated by dots. 
For instance, ours is: 


192.168.0.41 


Write this number down. You’|l need it shortly. 


Connect via SSH 

Open Command Prompt on a Windows PC, 
or a Terminal window in Linux or macOS. 
Enter this command: 


ssh pi@<IP> 


Replace <IP> with the IP address of the Raspberry 
Pi. In our case, we enter ssh pi@192.168.0.41. 

The first time you do this, you’ ll get a message 
saying that the authenticity can’t be established, 
followed by a long cryptographic hash of letters 
and numbers. It will say, ‘Are you sure you want to 
continue connecting” 

Enter yes and press RETURN. You’!l be asked to 
enter the password for your Raspberry Pi. 
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On Raspberry Pi 

You will now see your usual command line 
replaced with pi@raspberrypi: ~$. You are now 
logged in and working on the command line from 
your Raspberry Pi. Enter 1s and you’11 see Desktop, 
Downloads, Documents, and the other unique 
Raspberry Pi folders and files. You can create, edit, 
move, and work with files as if you were using 
Terminal on your Raspberry Pi. 


pi@raspberrypi: ~ ‘ 
Edit Tabs Help 


TopTip & 


SSH from boot 


You can activate 
SSH when setting 
up Raspbian 

by placing a 

file named ssh, 
without any 
extension, onto 
the boot partition 
of the microSD 
card from another 
computer. When 
Raspberry Pi 
boots, it looks for 
the ssh file. If it 

is found, SSH is 
enabled and the 
file is deleted. The 
content of the file 
does not matter; it 
could contain text, 
or nothing at all. 


Use the hostname 
command in 
Terminal to confirm 
the host name 
‘raspberrypi’, 

and add the -I 

flag to get your 
assigned IP (internet 
protocol) address 
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Turn SSH on 
and off 


You can activate 
and start 

SSH from the 
command line on 
your Raspberry Pi: 


sudo systemctl 
enable ssh 
sudo systemctl 
start ssh 


And turn it off 
using: 


sudo systemctl 
stop ssh 

sudo systemctl 
disable ssh 


Visual interfaces 

There are limitations to SSH. A plain 
SSH connection can’t open programs that use a 
graphical interface, so you should learn to use 
command-line alternatives (such as nano or vim 
instead of Leafpad for text editing). See How to Edit 
Text files on Raspberry Pi (magpi.cc/BNFKeP). 

On Linux computers, you can forward your X 

session over SSH, to allow the use of graphical 
applications, by using the -Y flag: 


ssh -Y pi@<IP> 


Now you are on the command line as before, but 
you have the ability to open up graphical windows. 
For example, typing: 


scratch & 


...will open up Scratch in a graphical window. 
Note that X11 is no longer present on Macs 

with macOS (magpi.cc/AqEvnA), so you have to 

download and install it (xquartz.org) separately to 

access graphical windows over SSH. 


oo 


A Use SFTP (Secure File Transfer Protocol) in a program 
such as FileZilla to transfer files to and from your 
Raspberry Pi via a graphical interface 


scp Downloads\MagPi83.pdf pi@192.168.0.41:/ 
home/pi/MagPi 


This copies The MagPi issue #83 PDF from the 
Downloads folder on our Windows PC to the MagPi 
directory on Raspberry Pi. 

Notice that the directory path uses backslash (‘\’) 
for Windows source and slash (‘/’) for the Linux 
destination (if you’re using a Mac or Linux machine, 
it'll be a slash in both source and destination.) 


07 Copy files 
It’s not easy to share files using Secure 
Shell from the command line, but it’s possible 
and a handy skill to learn. If you’re still accessing 
Raspberry Pi, enter exit at the command line to 
return to your local shell: 


exit 


With SSH turned on, you can copy files from 
your source computer to the Raspberry Pi using 
SCP. We’ve downloaded The MagPi issue #83 
(magpi.cc/83) PDF file to our Downloads folder. 
We’re going to copy it to the MagPi directory on 
our Raspberry Pi. 

Use the scp command followed by the path to the 
source file, and then the destination location. 
The destination is pi@<IP> followed by a colon ‘:’ 
and the path to the destination location. 


scp <source> pi@<IP>:<destination> 


Replace the <source> and <destination> parts with 
the paths to the file and desired destination folder, 
and add your Raspberry Pi’s IP address. 

For instance, copying the PDF file on our 
machine looks like this: 
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Copying files 

If you copy a lot of files back and forth from 
a computer to Raspberry Pi, then it’s a good idea to 
set up SFTP using a dedicated FTP program, such as 
FileZilla (filezilla-project.org). 

Install FileZilla on your computer (it is available 
for Linux, Windows, and macOS). 

Open FileZilla and choose File > Site Manager. 

Now click New Site and you can give the site a 
custom name, such as ‘Raspberry Pi’. 

Change the Protocol to ‘SFTP — SSH File 
Transfer Protocol’. 

Enter ‘raspberryp?’ in the Host field, ‘pi’ in the 
User field, and your Raspberry Pi password in the 
Password field. 

Click Connect and you will connect remotely to 
the Raspberry Pi. You will see all your Raspberry Pi 
files in the right-hand ‘Remote’ side of the display. 
On the left, in the ‘Local Site’ section will be all 
the files on your computer. Double-click directory 
folders in either side to navigate into them, and 
use the ‘..’ folders at the top of each list to navigate 
back up to the parent folder. 

Double-click a file in Local Site to send 
it to the Remote section, and vice versa. 

Follow the FileZilla tutorial if you need more 
guidance (magpi.cc/WovBgn). {/ 


J 
,°s a, ww Gan Ly 
az. 


hs 
_ = 


z 4 ; i : . “ A 
Be Vilros Raspberry Pi 3 Model B aR Vilros Raspberry Pi 3 Model B+ 
re % Retro Pi Arcade Gaming Kit with Retro Arcade Gaming Kit With 
aa A Classic USB Gamepad ah >< Do | Retro Gaming Controller Set 
a += 
} } ef $79.99 $75.99 ARI Qe $1699 $109.99 


Vilros Retro Gaming USB Classic 


e.°* f Vilros Raspberry Pi 3 Model B 
e, % 


we Plus Retro Gaming Kit with 2 Controller Set of 5 
* = © Gamepads & Fan-Cooled Retro $39.99 $37.99 
| Avs Gaming Case 
—S $89.99 $85.49 
. ¥ 
0 ej j 
_USE THE CODE FOR 5% OFF Check us out at (£)(¥) (@) Wvilrosusa 


Crack Coupon Code for MGMt3M4OD 


“*Restrictions Apply" "**Offer Expires May 31, 2019 


WN Magri | TUTORIAL 


Melissa 
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Melissa works on 
the compatibility 
layer for Python that 
allows Raspberry 

Pi to use many of 
the CircuitPython 
libraries. She is 
currently working 
full-time on 
Adafruit projects. 
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| You'll Need 


» 16-Channel Servo 
Driver 
magpi.cc/fepZYG 


>» BNO055 9-DOF 
Breakout 
magpi.cc/UBiKnr 


» 2x Servos 
magpi.cc/syOCun 


» 5V power supply 
magpi.cc/kzPRHr 


» Female DC power 
adapter 
magpi.cc/fjPTMp 


» Breadboard 


» Jumper wires 


Control servos 
with CircuitPython 
and Raspbelry Pl 


Want to use your powerful new Raspberry Pi 4 to control 
gd robot? Adafruit's Blinka library makes it very easy 


for controlling robots. In celebration of 
Adafruit’s upcoming CircuitPython Day 
(8 August 2019), we’re going to take a look at how 
easy it is to use CircuitPython on Raspberry Pi. 
CircuitPython is designed to control low-cost 
microcontroller boards. For running robotics, 
Adafruit has many different breakout sensors and 
boards. We’re going to be looking at two boards 
that make a great combination in robotics: the 
BNO055 9-Degrees-of-Freedom (DOF) Absolute 
Orientation Breakout and the 16-Channel 12-bit 
PWM/Servo Driver. 
The BNO055 is unique in that the sensor includes 
a built-in microprocessor that takes all of the data 
from the other sensors and calculates everything 
you want to know, for improved accuracy. 


R aspberry Pi 4 is the perfect computer 


4 
| 


1 


A Rather than spending weeks or months fiddling with 
algorithms of varying accuracy and complexity, you can 
have meaningful sensor data in minutes 
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The 16-channel servo driver allows you to 
drive up to 16 different servos, which is excellent 
for robotics. Both of these boards can be driven 
through I’C, so they only take up two pins on 
Raspberry Pi. For this project, you will need both 
male-to-male and male-to-female jumper wires. 


Solder the headers 

If you haven’t already soldered the headers 
that came with the breakouts to the boards, let’s 
do it. One of the easiest ways is to cut the headers 
to length and insert them into some breadboard 
with the long pins facing down. Then place the 
breakout on the pins, apply heat, and solder. 

Once you have all of the headers connected, 

take the servo driver, flip it over, and solder the 
terminal block to the top side. Optionally, you 
can also add a capacitor to the servo driver board, 
especially if you have a lot of servos. 


Connect the servo driver 

The first item that we’ll hook up is the 
16-channel servo driver. Insert the breakout into 
the breadboard and wire it up to your Raspberry 
Pi according to the diagram (Figure 1). Take the 
female DC power adapter, loosen the screws, insert 
a male-to-male jumper wire in each hole, and 
tighten down the screws. Connect the other ends 
of the jumper wire into the terminal block on the 
servo driver according to the diagram. Be sure to 
connect the 5 V wire to VCC and not V+. 


The BNOO55 computes 
motion data for extreme 
ease of use with tracking 


Connect the orientation sensor 

The next item we’ll hook up is the BNO055 
Absolute Orientation Sensor. Insert the breakout 
board into the breadboard. Connect the four 
wires according to the Figure 1 diagram. Since 
this is using IC like the previous board, all four 
wires should be connected in parallel. Once that 
is connected, you can plug the two servos into 
the servo driver in positions 0 and 1, minding the 
orientation of the plug. Lastly, don’t forget to 
apply external power to the servo driver through 
the barrel connector we wired up in the last step. 


Prepare your Raspberry Pi 

Start by downloading and flashing the latest 
version of Raspbian Buster onto a microSD card. 
You should be able to use any of the available OS 
versions for this project, since we will be doing 
most of the steps from the command line. 

Place the microSD card into your Raspberry Pi, 
power up, and follow the usual setup prompts. 
When requested, update and reboot if necessary. 
If you are running Buster Lite, be sure to run the 
following command: 
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TopTip & 


Easy alignment 


A little trick that 
makes soldering 
connectors easier 
is to solder the 
first pin, check 
alignment, 

and reheat if 
necessary. 


The PCA9685 allows 
you to drive up to 16 
servos, or more when 
chained together 


™ Both of these boards can be driven 
through |*C, so they only take up two 
pins on Raspberry Pi @ 


a 7 Use a screwdriver to 
a connect the male-to- 

male jumpers to the 

female DC adapter 


sudo apt update && sudo apt upgrade 


If you are running the desktop version, you will 
automatically be prompted to update. Updating is 
very important. 
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P Six address-select 


pins so you can wire 
up to 62 of these on 
a single I?C bus -a 

total of 992 outputs 


The PCAQ685 servo 
driver is able to drive 
up to 16 servos and 
only uses a few pins 
on Raspberry Pi 


TopTip & 


Reuse an 
old board 


Did you upgrade 
your old 
Raspberry Pi for 
a new Raspberry 
Pi 4? Put it to 
good use: Blinka 
runs on older 
Raspberry Pi 
boards too. 
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Laying the foundation 

Next, we’re going to install some of 
the dependencies that we will need. If you are 
running the desktop versions, start by opening 
up a Terminal window (CTRL+ALT+T). Raspbian 
Buster should come with Python 3 and pip3, which 
are required; if not, you can run the following 
command to install them: 


sudo apt-get install -y python3 git 
python3-pip 


Next, install or upgrade setuptools by typing the 
following command: 


sudo pip3 install --upgrade setuptools 


The setuptools package in Python will help with 
installing Blinka when we get to it in a few steps. 
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Enabling the interfaces 

Now we need to enable the I?C interface, 
which both of the boards use. We’re going to use 
the raspi-config tool for this. If not already at a 
command prompt, open up a Terminal window. 
Type the following command: 


sudo raspi-config 


Once raspi-config opens up, open up Interfacing 
Options, select ‘I2C’, and choose Yes to enable the 
PC interface. 

Next, go back into Interfacing Options again 
and do the same thing, except this time selecting 
‘SPP to enable the SPI interface so that you’ ll have 
it available. 


07 Enable clock-stretching 

Certain I?C sensors such as the BNO055 need 
to have clock-stretching enabled. This slows down 
the PC clock so the sensor can keep up with the 
speedy Raspberry Pi and not drop any data. We’ ll 
want to slow it down from 100kHz to 10kHz. We do 
that by adding a line to the configuration file. To 
enable clock-stretching, you’ ll want to open up 
/boot/config.txt in your favourite editor (e.g. nano). 
At the end of the file, add the following line: 


dtparam=i2c_arm_baudrate=10000 


After that, save the file and reboot your Raspberry 
Pi. Clock-stretching is now enabled. 


A Blinka is the name of the CircuitPython compatibility 
layer that runs on Raspberry Pi, and is named after the 
CircuitPython mascot 


Install Blinka 

Next, we want to install any remaining 
Python libraries that Blinka requires. For the first 
one, we’ll use RPI.GPIO, which should already 
be installed. You can verify this by going toa 
command prompt and typing: 


pip3 install RPI.GPIO 


Finally, we’ll actually install Blinka. As well as 
Blinka itself, this will install a few dependencies 
such as PurelO and PlatformDetect. Type the 
following command to install Blinka and any 
other dependencies: 


pip3 install adafruit-blinka 


Install driver libraries 

Next, we need to install the required 
libraries to use Blinka with the BNO055 and servo 
driver. Make sure you have a Terminal window 
open and type the following commands: 


pip3 install adafruit-circuitpython-pca9685 
pip3 install adafruit-circuitpython-servokit 
pip3 install adafruit-circuitpython-bno@55 


This will install the drivers for both boards, as well 
as the ServoKit helper library that makes using 
Servos very easy. 


A The PCAQ685 servo driver allows Raspberry Pi to drive 
some fairly large and powerful servos 
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M Enabling clock-stretching 
Slows down the |°C clock so 
the sensor can keep up with 
the speedy Raspberry Pi and 
not drop any data 


DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/GNXPon 
eo1. """ 


@@2. In this Demo we will drive two servos based on the Tilt 


tiltdemo.py 


> Language: Python 3 


along the Y and Z axis 

@@3. of the BNO@55 9-Degrees of Freedom IMU Sensor. This could 
easily be extended 

@@4. to drive servos on all three axis as well as use a host 
of other information 

605. including lateral acceleration. 

ee6. """ 

007. 

008. import board 

009. import busio 

Q18. from adafruit_servokit import ServoKit 

Q@11. import adafruit_bno@55 


@12. 

013. # Set channels to the number of servo channels on your 
kit. 

@14. kit = ServoKit(channels=16) 

e15. 


616. # Setup the BNO@55 to read data 
@17. i2c = busio.12C(board.SCL, board.SDA) 
@18. sensor = adafruit_bno@55.BNO@55(i2c) 


e19. 

@20. while True: 

621. # Get the Euler angles from the BNO@55 

@22. (x, y, Z) = sensor.euler 

@23. 

Q24. # Euler angles are between -180 and 180 

@25. # We want to translate them to the Servo angles 
between 0-180 

026. try: 

@27. kit.servo[@].angle = (y + 180) / 2 

e28. kit.servo[1].angle = (z + 180) / 2 

@29. except ValueError: 

30. # Pass on any values that are out of range 

Q31. pass 
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The CRICKIT HAT 
makes robotics easy 
on Raspberry Pi 


Other options 

Adafruit offers plenty of other options 
for using Raspberry Pi for robotics, including the 
CRICKIT HAT. This plugs right into the GPIO header 
on Raspberry Pi and allows up to four servos, but is 


As you tilt the breadboard in various 
directions, the servos should respond 
depending on the axis 


Running the code 

Now we want to save the demo code in 
your home directory (/home/pi) on Raspberry Pi. 
You can either open up your favourite editor on 
Raspberry Pi and enter it directly, or copy the file 
with an SCP or FTP utility if you have those services 
enabled. Once you have the code in your home 
directory, you can run it from the command line by 
typing the following: 


python3 demo. py 


Once you have the code running, pick up your 
breadboard and start moving it around. As you tilt 
it in various directions, the servos should respond 
depending on the axis that you tilt around. You 
could always add a third servo and respond to the 
third axis and slightly modify the code. 
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also able to control stepper motors and DC motors, 
drive NeoPixels, play sound through a speaker, and 
has capacitive touch. It has eight digital/analogue 
inputs that can also be configured as digital 
outputs. All the features on this board are wrapped 
up in one nice CircuitPython library. 


More learning resources 

Adafruit offers many more learning guide 
resources to show you what the Raspberry Pi 
is capable of and so much more. At the time of 
writing, there are close to 2000 guides available. 
You can go to learn.adafruit.com and browse 
through all of the guides available. 

CircuitPython is being added to more boards all 
of the time, with guides being written for them. 
You can always go to circuitpython.org/blinka to 
see which other boards are supported. 


Displays Cases Project Kits Add-on Boards 
HATs Arcade Cameras Cables and Connectors 
sensors Swag Power Options GPIO and Prototyping 


Partner and official reseller for top Pi brands: 


Se. and many 
Wadatruit Sparkfun., PIMORONI “9 HiFi others! 
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Build Demolition Mans 
verbal morality 
ticketing machine 


Use voice recognition and a thermal printer to issue 
printed fines if your friends say a swear word 


Evans 


PJ is a writer, trainer, 
developer, and 
wrangler of Milton 
Keynes Raspberry 
Jam. He wishes 

you joy-joy and 
mellow greetings. 


@mrpjevans 


[ You'll Need 


» USB microphone 
magpi.cc/NwjF0a 


» Speaker pHAT 
magpi.cc/TkYcvO 


» Thermal printer 
magpi.cc/xbfAtk 


» 3D-printed case 
magpi.cc/fHeMry 


Sylvester Stallone stars as a 1990s cop 

transported to the near-future. Technology 
plays a central role in the film, often bemusing 
the lead character. In a memorable scene, he is 
repeatedly punished by a ticketing machine for 
using bad language (a ‘violation of the verbal 
morality statute’). 

In the future, an always-listening government 
machine detects every banned word and issues a 
fine in the form of a receipt from a wall-mounted 
printer. This tutorial shows you how to build 
your own version using the Google Voice API 
and a thermal printer. Not only can we replicate 
detecting banned words, but it also doubles as a 
handy voice-to-paper stenographer (if you want a 
more serious use). 


[ n the 1993 action movie Demolition Man, 


A Luckily, the printer's connector matches up with 
the GPIO pins and can be directly attached 
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Prepare the hardware 

We built a full ‘boxed’ project, but you can 
keep it simple if you wish. Raspberry Pi needs a 
method for listening, speaking, and printing. The 
easiest solution is to use USB for all three. After 
prototyping using Raspberry Pi 4 and various 
USB devices, we settled on a Raspberry Pi Zero W 
with a small USB mic and Pimoroni Speaker pHAT 
to save space. A Pico HAT Hacker allowed the 
connection of both the printer and Speaker pHAT, 
as they don’t share GPIO pins. This bit of space- 
saving means the full assembly can be installed 
inside the 3D-printed case, along with the printer. 


Connect the printer 

To issue our receipts we’re using a thermal 
printer, the kind found in supermarket tills. 
This particular model is surprisingly versatile, 
handling text and graphics. It takes standard 
2.25-inch (57 mm) receipt paper, available in rolls 
of 15 metres. When printing, it does draw a lot 
of current, so we advise using a separate power 
supply. Do not attempt to power it from your 
Raspberry Pi itself. You may need to fit a barrel 
connector and source a1.5A,5V supply. The 
printer uses a UART/TTL serial connection which 
neatly fits on to the GPIO. Although the printer’s 
connection is listed as being 5V, it is in fact 3.3V, 
so can be directly connected to the ground, TX, and 
RX pins (physical pins 6, 8, 10) on the GPIO. 


This thermal printer 
does not require ink 
and uses standard 
receipt rolls 


Tucked inside are 
a Raspberry Pi 
Zero W, speaker, 
and microphone 


Install and configure Raspbian 

Get yourself a copy of Raspbian Buster Lite 
and burn it to a microSD card using a tool like 
Etcher. You can use the full version of Buster if 
you wish. Perform the usual steps of getting a WiFi 
connection and updating to the latest version using 
sudo apt update && sudo apt -y upgrade. From 
acommand prompt, run sudo raspi-config and 
go to ‘Interfacing options’, then ‘Enable serial’. 
When asked if you would like the login shell to be 
accessible, respond ‘No’. On the next question, 
‘Would you like the serial port hardware to be 
enabled’ reply ‘Yes’. Now reboot your Raspberry Pi. 


printer.py 
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DOWNLOAD 
THE FULL CODE: 


> Language: Python 3 


wy) magpi.cc/WYrUcu 


ee1. 
0e2. 
003. 
004. 
Q@5. 


from thermalprinter import ThermalPrinter 


with ThermalPrinter(port='/dev/serial@') as printer: 
printer.out("Hello, world!") 
printer. feed(2) 


speech_to_text.py 


> Language: Python 3 


Test the printer 

Let’s make sure the printer is up and 
running. Double-check you’ve connected the 
header to the GPIO correctly and power up the 
printer. The LED on the printer should flash every 
few seconds. Load in the paper and make sure 
it's feeding correctly. We can talk to the printer 
directly, but the Python ‘thermalprinter’ library 
(magpi.cc/JbfiPV) makes coding for it so much 
easier. To install the library: 


sudo apt install python3-pip 
pip3 install thermalprinter 


Create a file called printer.py and enter in the code 
in the relevant listing. Run the code using: 


ee1. 
0e2. 
003. 
004. 
e005. 
006. 
007. 
008. 
ee9. 
e108. 
Q11. 
Q12. 
Q13. 
e14. 
Q15. 
016. 
017. 
e18. 
e19. 
20. 
Q21. 
@22. 
23. 
24. 
@25. 
26. 
027. 
28. 
29. 
030. 
31. 


import io 
import os 


# Imports the Google Cloud client library 
from google.cloud import speech 

from google.cloud.speech import enums 
from google.cloud.speech import types 


# Instantiates a client 
client = speech.SpeechClient() 


# The name of the audio file to transcribe 
file_name = os.path. join( 
os.path.dirname(__file_), 
'test.wav') 


# Loads the audio into memory 

with io.open(file_name, ‘rb') as audio file: 
content = audio_file.read() 
audio = types.RecognitionAudio(content=content) 


config = types.RecognitionConfig( 
encoding=enums. RecognitionConfig.AudioEncoding.LINEAR16, 
sample_rate_hertz=44100, 
language_code='en-GB') 


# Detects speech in the audio file 
response = client.recognize(config, audio) 


for result in response.results: 
print('Transcript: {}'.format( 
result.alternatives[@].transcript) ) 
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> Any mix of USB 


speakers and 
microphones will 
do, although the 
better the mic, the 
more accurate the 
voice recognition 


TopTip & 


Better mic for 
better results 


The quality of 
the microphone 
is key, especially 
if you want 

this to work at 

a distance. 


Fa 


a 


python3 printer.py 


If you got a nice welcoming message, your printer 
is all set to go. 


Say a few words, then use CTRL+C to stop 
recording. Check the playback with: 


aplay test.wav 


Test the microphone 
Once your microphone is connected to 
Raspberry Pi, check the settings by running: 


alsamixer 


This utility configures your various sound devices. 
Press F4 to enter ‘capture’ mode (microphones), 
then press F6 and select your device from the list. 
Make sure the microphone is not muted (M key) 
and the levels are high, but not in the red zone. 
Back at the command line, run this command: 


arecord -1 


This shows a list of available recording devices, one 
of which will be your microphone. Make a note of 
the card number and subdevice number. 

To make a test recording, enter: 


arecord --device=hw:1,0 --format S16_LE 
--rate 44100 -c1 test.wav 


If your card and subdevice numbers were not ‘0,1’, 
you’ ll need to change the device parameter in the 
above command. 
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Choose your STT provider 

STT means ‘speech to text’ and refers to the 
code that can take an audio recording and return 
recognised speech as plain text. Many solutions are 
available and can be used in this project. For the 
greatest accuracy, we’re going to use Google Voice 
API. Rather than doing the complex processing 
locally, a compressed version of the sound file is 
uploaded to Google Cloud and the text returned. 
However, this does mean Google gets a copy of 
everything ‘heard’ by the project. If this isn’t for 
you, take a look at Jasper (magpi.cc/OsiutD), an 
alternative that supports local processing. 


07 Create your Google project 
To use the Google Cloud API, you’ll need 

a Google account. Log in to the API Console at 
console.developers.google.com. We need to 
create a project here. Next to ‘Google APIs’, click 
the drop-down, then ‘New Project’. Give it aname. 
You’ll be prompted to enable APIs for the project. 
Click the link, then search for ‘speech’. Click on 
‘Cloud Speech-to-Text API’, then ‘Enable’. At this 
point you may be prompted for billing information. 


Don’t worry, you can have up to 60 minutes of 
audio transcribed for free each month. 


Get your credentials 

Once the Speech API is enabled, the screen 
will refresh and you’ll be prompted to create 
credentials. This is the info our code needs to be 
granted access to the speech-to-text API. Click on 
‘Create Credentials’ and on the next screen select 
‘Cloud Speech-to-text API’. You’re asked if you’re 
planning to use the Compute Engine; select ‘no’. 
Now create a ‘service account’. Give it a different 
name from the one used earlier, change the role 
to ‘Project Owner’, leave the type of file as ‘JSON’, 
and click ‘Continue’. A file will be downloaded to 
your computer; transfer this to Raspberry Pi. 


Test Google recognition 

When you’re happy with the recording 
levels, record a short piece of speech and save it 
as test.wav. We’ll send this to Google and check 
our access to the API is working. Install the Google 
Speech-To-Text Python library: 


sudo apt install python3-pyaudio 
pip3 install google-cloud-speech 


Now set an environment variable that the libraries 
will use to locate your credentials JSON: 


export GOOGLE_APPLICATION_CREDENTIALS="/ 
home/pi/[FILE_NAME].json" 


(Don’t forget to replace [FILE_NAME] with the actual 
name of the JSON file) 

Using a text editor, create a file called 
speech_to_text.py and enter the code from the 
relevant listing. Then run it: 


python3 speech_to_text.py 


If everything is working correctly, you’ ll get a text 
transcript back within a few seconds. 


Live transcription 

Amazingly, Google’s speech-to-text 
service can also support streaming recognition, 
so rather than capture-then-process, the audio 
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can be sent as a stream and a HTTP stream of the 
recognised text comes back. When there is a pause 
in the speech, the results are finalised, so then 

we can send the results to the printer. If all the 
code you’ve entered so far is running correctly, 

all you need to do is download the stenographer.py 
script from magpi.cc/WYrUcu and start it using: 


TopTip & 


Print more 


Thermal printing 
is great fun. 
Explore the 
Python libraries 
to generate 
barcodes 

and images. 


python3 stenographer. py 


You are limited on how long you can record for, but 
this could be coupled with a ‘push to talk’ button 
so you can make notes using only your voice! 


M In the event anyone mentions a banned 
word, d buzzer will sound and a fine will 
be printed @ 


Banned word game 

Back to Demolition Man. We need to make 
an alarm sound, so install a speaker (a passive one 
that connects to the 3.5mm jack is ideal; we used a 
Pimoroni Speaker pHAT). Download the banned.py 
code from magpi.cc/WYrUcu and edit it in your 
favourite text editor. At the top is a list of words. 
You can change this to anything you like (but don’t 
offend anyone!). In our list, the system is listening 
out for a few mild naughty words. In the event 
anyone mentions one, a buzzer will sound anda 
fine will be printed. Make up your list and start the 
game by running: 


python3 banned. py 


Now try one of your banned words. 


Package it up 

Whatever you decide to use this project 
for, why not finish it up with a 3D-printed case so 
you package up the printer and Raspberry Pi with 
the recording and playback devices and create a 
portable unit? Ideal for pranking friends or taking 
notes on the move! 

See if you can invent any other games using 
voice recognition, or investigate the graphics 
capability of the printer. Add a Raspberry Pi 
Camera Module for retro black and white photos. 
Combine it with facial recognition to print out an 
ID badge just using someone’s face. Over to you. Ml 
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Dan 
Lambton-Howard 


Dan is an 
independent game 
designer based in 
Newcastle upon 
Tyne, where he is 
lucky enough to 
make games for 
his PhD. 


@danhowardgames 


[ You'll Need 


» PICO-8 
magpi.cc/pico8 


» Keyboard and 
mouse 


P Ourcute spaceship 
Sorry, we mean, 
hyper advanced 
warfighter.. ahem 


Learn Lua 


with PICO-8 


You've played other people's PICO-8 games, now it's time to make your 
own! Create a retro space-shooter whilst learning the Lug language 


and easy-to-learn language called Lua. 

It’s quick, powerful, and is by far the most 
popular scripting language in game development 
today, having been used in everything from Dark 
Souls to World of Warcraft. So even if you’re just 
a little bit interested in game dev, it’s a good skill 
to have. This tutorial will walk you through using 
Raspberry Pi and PICO-8 to make a simple retro 
space-shooter, a great foundation for things 
to come. 


C oding in PICO-8 is done in a lightweight 


Launch sequence initiated 

First things first, launch PICO-8 and, from 
the console, hit ESC. You should now be staring 
at the code editor. It isn’t the most beautiful text 
editor, but you’ll sure grow to love it! We want 
to start with a blank slate, so if you already have 


- i gaee 
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a cart loaded you might need to reboot in the 
console. Before we start with the code, two things 
to note: PICO-8 doesn’t use upper case letters, 
everything is lower case (so hands off that Caps- 
Lock). Secondly, similar to Python, there is no need 
for semicolons to end lines. 


The holy trinity of PICO-8 

PICO-8 has three special functions that 
structure any PICO-8 program. The first, _init(), 
is run once at program startup, whilst _update() 
and _draw() are called 30 times a second, meaning 
games are 30 fps by default. Define these three 
functions in your code, as in Figure 1. You can also 
give your game a title by using -- to comment. 
We’ve chosen something suitably B-movie for 
our retro space-shooter. Hit ESC to return to the 
terminal and type save yourgamename to save your 
cart (you should do this often), then ESC again to 
hop back to the code editor. 


Ready Player One 

No space-shooter is complete without a 
solitary pilot flying a super-advanced experimental 
warfighter. Switch to the sprite editor (using the 
tabs at the top right) and draw our ship. Don’t 
worry too much about graphics as we’ll be covering 
that in a later tutorial. Doodle a spaceship facing 
right in sprite slot 001. Write the following code 
into your _init() function to declare the player as 
atable: player = {x=20,y=64,sprite=1}. Tables are 
very useful in Lua; this one contains a reference to 
your player’s x and y coordinates, as well as what 
sprite to draw. 


Those blobs came from the moon! Don't worry too much 
about graphics at this stage 


Moving the player 

Now, within the _draw() function, 
add cls(). Then, on a new line, add 
spr(player.sprite, player.x,player.y). This will 
tell PICO-8 to clear the screen each frame, then 
draw the player at the x and y coordinates stored 
in the player table. You can test this by hitting 
CTRL+R. You should see your little ship on the 
screen. Now let’s get them moving! The following 
code placed in the _update() function should move 
the player when the direction keys are pressed. 


if btn(@) then player.x-=2 end 
if btn(1) then player.x+=2 end 
if btn(2) then player.y-=2 end 
if btn(3) then player.y+=2 end 


The enemy reveal themselves 

But what are we fighting against? Those evil 
green blobs from outer space, that’s who! Draw a 
suitably alien-looking creature in sprite slot 002. 
We want our enemies to be attacking in waves. 
You can see the full code in the source, but briefly 
we are declaring a new empty table in _init() 
named enemies. Then we write a new function 
create_enemies() which creates anew enemy 
(similar to how we created the player) and then 
adds it to the enemies table. Lastly, a new function 
create_wave() spawns a number of enemies. 


They're coming for us! 

To actually draw the enemies, we need to 
write a for loop in _draw(). This loops over all 
the enemies in our enemies table, once per frame, 


FUNCTION INIT! 3 


O-UPDATEE 3 


FUNCTION ORAUC J 
oO 


LINE L1fll 


These three special functions 


are your game Loop: initialise, 
update, and draw 


MaigPi 


i 


PICO-8 has a strict limit on 
code complexity, great for 
avoiding feature creep! 


Aliens dre no threat if they just sit 
there, so we need them to come 


towards the player 


and draws them on the screen. Aliens are no 
threat if they just sit there, so we need them to 
come towards the player. A simple way of doing 
this is to write another loop in _update()that 
alters each enemy’s x value per frame. Now let’s 
actually spawn some. Add create_wave(rnd(6)+5) 
into _init(). This will call our enemy wave 
function that we wrote earlier, and create five to 
ten aliens on startup. 


Our pilot strikes back 

Run your game and you should be 
immediately swarmed by aliens. We need some 
way of fighting back! Let’s code some lasers. 
We do this in a very similar way to enemies, by 
declaring an empty lasers table, making a new 
function to create a laser, and writing a for loop 
to update each laser’s position, and one to draw 


Learn Lua with PICO-8 


Top Tip 


Don't trip over 
a table 


Lua’s tables are 
a flexible and 
powerful data 
type. But beware: 
indexing starts 

at 1 and not o 
like in most other 
languages! 
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P it's amazing how 
quickly you can geta 
game up and running 
on PICO-8 


TopTip & 


Organise 
your code 


A great way to 
keep your code 
under control is 
to use PICO-8's 
built-in tabs, 
found in the top- 
left corner of 
the editor. 


SCORE: 400 


each laser (as a red rectangle). The difference is 
we add if btnp(4) then create_laser(player. 
x+5,player.y+3) end after our player movement. 
This creates a new laser in front of the player 
when they press X (or B button on a controller). 


High-speed collision 

You’ve probably noticed that our lasers are 
entirely ineffective against the alien scum. That’s 
because we haven’t coded any collision detection. 
There are many ways to do this — entire books have 
been written about the topic — but let’s keep things 
simple. We’ll declare a new enemy_collision() 
function that checks if a point is inside an 8x8 
pixel square around an enemy. If so, it returns 
true. Next, within our enemies update loop (step 6) 
we’ll also loop through the lasers table to check 
collisions; if so, we delete both the laser and the 
enemy, destroying them both. Kerpow! 


™ Upon a collision, we delete both the laser 
and the enemy, destroying them both @ 


Game over 

The tides of battle have turned, but it’s 
hardly a fair fight. Let’s reuse the same collision 
function to check if an enemy has struck the player. 
Again, within the enemy update loop, we check for 
collision with a point in the player’s ship. If we find 
a collision, we’ll declare a new variable gameover = 
true (cue dramatic music). We will then wrap the 
player move and draw code in a conditional if not 
gameover then [code] end, so that the player can’t 
keep playing, and a print statement in _draw() to 
really hammer the point home. 
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They just keep coming 

So now we have our pilot, lasers, aliens, and 
some collisions. But let’s increase the tempo and 
have aliens arriving in ever-increasing waves. To 
do this we will create a timer that increments each 
frame, and spawn a new wave every three seconds. 
Declare wavetimer = @andwaveintensity = 5in_ 
init() and then, in _update(), increment the timer 
by one. Let’s also include a conditional that spawns 
a new wave, and increases the intensity, when the 
timer hits 90 (30 frames per second * 3). 


Space debris 

Now we need to do a bit of tidying up. For 
example, those lasers you’ve been firing? They 
don’t actually stop off screen, you know. They 
continue forever, and will eventually start slowing 
down PICO-8 as it tries to process thousands 
of off-screen lasers. The same for aliens. To fix 
this, within the laser and enemy update loops, 
check if each is out of screen bounds (0-127 for 
both x and y) and delete any strays. Additionally, 
to prevent the player from going off screen, add 
player.x = mid(@,player.x,12@), and the same for 
y, in __update(). 


Scoring big 

Survival is one thing, but high scores are 
better. To cap this tutorial off, create a new variable 
score = @in_init() and adda new line when 
an alien is destroyed that adds to score. Choose 
whatever amount you want, but 100 sounds good, 
doesn’t it? Adding print('score: '..score,2,2,7) 
to the end of _draw() should show the score on 
screen. That’s all for now, but we’ll be looking at 
graphics and sound in the next few issues, as well as 
giving our little space-shooter some more oomph! 


A Lua is used extensively in World of Warcraft 
as a scripting language 
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SpaceShooter.p8 


>» Language: Lua 


DOWNLOAD 
THE FULL CODE: 


iw) magpi.cc/eDDppk 


0e1. 
0e2. 
0e3. 
004. 
0e@5. 
006. 
007. 
008. 
0e9. 
018. 
011. 
012. 
013. 
014. 
015. 


016. 
017. 
018. 
19. 
820. 


21. 
Q22. 
023. 
024. 
25. 
026. 
027. 
028. 


Q29. 


030. 
Q31. 
Q32. 
033. 
034. 
Q35. 
036. 


037. 
038. 
39. 
04e. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 


--attack of the green blobs 
--by dan lambton-howard 
function _init() -- called once at start 
player = {x=20, y=64, sprite=1} --player table 
enemies = {} 
lasers = {} 
create_wave(rnd(6)+5) --start game with a wave 
wavetimer = @ 
waveintensity = 5 
score = @ 
end 


function _update() -- called 3@ times per second 
wavetimer+=1 
if not gameover then --only move the player if 
not gameover 
if btn(@) then player.x-=2 end 
if btn(1) then player.x+=2 end 
if btn(2) then player.y-=2 end 
if btn(3) then player.y+=2 end 
if btnp(4) then create_laser(player. 
x+5,player.y+3) end 
end 
--stop player going off screen edges 
player. x=mid(0,player.x,120) 
player. y=mid(0,player.y,120) 


for enemy in all(enemies) do --enemy update loop 
enemy .x-=enemy.speed --move enemy left 
for laser in all(lasers) do --check collision 
w. laser 
if enemy_collision( 
laser.x,laser.y,enemy) then 
del(enemies , enemy) 
del(lasers, laser) 
score+=100 
end 
end 
--check collision w/ player 
if enemy_collision( 
player.x+4,player.y+4,enemy) then 
gameover = true 
end 
--delete enemy if off screen 
if enemy.x<-8 then 
del(enemies , enemy) 
end 
end 


for laser in all(lasers) do --laser update loop 
laser.x+=3 --move laser to the right 
if laser.x>130 then --delete laser if off screen 
del(lasers, laser) 
end 


50. 
@51. 
Q@52. 


@53. 
54. 
@55. 
Q56. 
Q@57. 
@58. 
@59. 
060. 
061. 
062. 


063. 
064. 
Q65. 
066. 
067. 
068. 
69. 
070. 
e71. 
Q72. 
073. 
074. 
Q75. 
076. 


077. 
078. 
Q79. 
080. 
081. 
82. 
083. 
084. 
Q85. 
086. 
087. 
088. 
89. 
e908. 
e91. 
e92. 


93. 
e94. 


@95. 
096. 
097. 
e98. 


end 


if wavetimer==90 then --every 3 seconds spawn 
wave 
create_wave(rnd(6)+waveintensity) 
wavetimer=0 -- reset timer 
waveintensityt+=1 
end 
end 


function _draw() --called 3@ times per second 
cls() --clear screen 
if not gameover then 
spr(player.sprite,player.x,player.y) --draw 
player 
end 


for enemy in all(enemies) do --draw enemies 
spr(enemy.sprite, enemy.x,enemy.y) 
end 


for laser in all(lasers) do --draw lasers 
rect(laser.x,laser.y, laser.x+2, laser.y+1,8) 
end 


if gameover then --print game over to screen 
print('game over' ,50,64,7) 
end 
print('score: 
screen 
end 
--creates an enemy at x,y with random speed 1-2 
function create_enemy(x,y) 
enemy={x=x, y=y, speed=rnd(1)+1, sprite=2} 
add (enemies , enemy) 
end 
--spawns a wave of enemies off screen 
function create_wave(size) 
for i=1,size do create_enemy(256,rnd(128)) end 
end 


..score,2,2,7) --show score on 


function create_laser(x,y) 

laser = {x=x,y=y} 

add(lasers, laser) 
end 
--returns true if x,y are within a 8x8 rectangle 
around enemy 
function enemy _collision(x,y, enemy) 

if x>=enemy.x and x<=enemy.x+8 and y>=enemy.y and 
y<=enemy.y+8 then 

return true 

end 

return false 
end 
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You'll Need 


IKEA Lillabo train set 
with track extension 
pack 
magpi.cc/FpUZix 


A/D converter from 
The MagPi #68 
magpi.cc/68 


Squeeze controller 
from The MagPi #83 
magpi.cc/83 


184 x \WS2812 LEDs 
on PCB 
magpi.cc/vsYpFe 
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LED Racer 


Warning! 
High voltage 


The dynamo torches in this 
project can produce high 
voltage, so be careful. 


Have you got what it takes to win the Formula One LED race? Run a race 
on your own LED track layout using your Squeeze controller 


ast month, we saw how to convert a dynamo 

torch into a controller. The more you 

squeezed it, the bigger signal you got. Now, 
we are going to put this to good use, by making an 
LED racer game. Back in The MagPi #41, we used a 
simple IKEA train to help teach reading, ‘The Story 
Train’. So we’ve used the wooden track from this 
as the basis of our game. You can still get these, 
although the bridge has changed a bit and more 
extra track sets are available. Other wooden train 
tracks could be used; just search online. 


rsa 


‘Lap Face 
Drews wpace for «new ree 


Dynamo torch 
controllers 
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The layout 

The track layout we chose to use has a bridge 
and two sets of points and is shown in Figure 1. This 
shows each individual piece of track, the sort of 
track section it is, along with the LED numbers we 
use. One lap of the track starts at piece S1 and goes 
round to the Points 1 piece and loops back to the 
Points 2 piece. The second time the Points 1 piece 
is reached, the other branch is taken and the track 
continues round to the start again. So we get a total 
track length of 231 steps from only 184 LEDs. 


Torch input 
and LED 
drive circuitry 


le 0 
Speed 0 


Figure 2 


A Figure 2 The need for a small piece of track 


Making the layout 

The desired track could not be made with 
the pieces we had, because we needed an extra 
short piece. This piece is in the newer sets, but 
not the one we had, so we had to make one - see 
Figure 2. We sawed a longer piece to the required 
length, then placed it over the hole end of another 
straight piece and marked the hole with a pencil. 
Then, we drilled a10mm hole where it was marked, 
and removed the end material with a saw. A 
combination of round and straight files made it fit 
the plastic stud from another piece — see Figure 3. 


Components 

We used individual WS2812B LEDs mounted 
on a PCB, and spaced them out such that the 
gap between the two plastic studs — used for 
joining two sections of track - was maintained 
throughout the rest of the track in LEDs. As we 
wanted to be able to take this project apart for 
storage, and transportation, we made each piece 
of track a standalone LED piece. This had a four- 
pin connector on the outside of each track piece 
roughly in the middle. This meant that we could 
make a wiring loom to connect it all up and store 
that separately. 


Templates 

In order to make a nice curve, we made 
the orientation of the individual LEDs change 
throughout the curve. To do this we drew a 
full-scale picture of a curve piece rotating each 
LED 11.25° so the 90° curve was completed with 
eight LEDs. We also drew the points and straight 
sections before printing these out on paper. Next, 
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stud LED's input 
hole LED's output 


n 
uw 


Be 
a 
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12 Clockwise Curves - connector long arc - 96 LEDs 

5 Straight long pieces - including bridge section - 55 LEDs 
1 Straight short piece - custom shortened - 5 LEDs 

2 Points - 15 + 13 LEDs 

Total number LEDs = 184 LEDs 


Figure 3a 


<4 Figure 3 
Making the 
small track 
piece froma 
larger one 
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Figure 4 


A Figure 4 Cutting out 


> 


the LED holes in the 
template 


Figure 5 Adding 
an extra layer of 
cardboard to the 
template 


TopTip & 


Wiring the LEDs 


It helps if the wire 
making the power 
rails are curved to 
begin with: stretch 
it with your hands 
to approximate the 
final shape first. 


Figure 7 Track 
section connector - 
use glue if itis nota 
tight fit 


Din Gnd +5V_ Dout 


Figure 5 


we glued each section to a piece of cardboard from 
a cereal box and cut out the LEDs’ squares with a 
scalpel. Figure 4 shows the LED squares being cut 
out of the template. 


Finishing off the template 

Then we used another piece of cardboard to 
draw through the square holes and cut then out. We 
made sure the holes were aligned by pushing an LED 
at each end and then the two pieces of cardboard 
were glued together — Figure 5. When the glue was 
set, we gave each template three coats of clear 
varnish to toughen them up and, when dry, placed 
them under heavy books for a few days to remove 
any curl. We also made the straight track and the 
points template. The template PDF files can be 
found on our GitHub page. 


Constructing the LED strips 

For strength, we used 22 SWG wire to 
make the power and ground connections. Start 
at one end and solder the wire to one power pad 
of the LED. Then, use pliers to bend the wire just 
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Figure 6 


A Figure 6 Wiring up a track section; note the extension wires on 
the data-in and data-out of the strip 


after this joint so that it lines up with the second 
LED’s pad, and solder that. Repeat this and when 
a run is finished, go back and solder the other 
power pad. Wire the data-in to the data-out of 
the central data chain with 28 SWG wire (we used 
stripped-back Kynar wire). Figure 6 shows the 
wiring of a finished curve. 


07 The track connector 
First off, we need to drill four holes, about 

1mm down from the top edge of the track in the 
approximate centre. We pushed the header pins 
into the wood so they made tiny indentations, then 
marked these with a sharp pencil, and drilled 1mm 
holes. Then we could push the long header into the 
wood and have just enough sticking out to connect 
some Kynar wire to the strip assembly. Figure 7 
shows how we wire the connector for all the tracks, 
with a white mark (from typing correction fluid) on 
the left side to mark the data-in signal. 


Fixing the strip to the track 

We found the quickest way to do this was 
with hot-melt glue, although if you have the time 
it might be simpler to use clear silicon adhesive. 
We put a generous helping of glue on the two 
plastic pieces at the end of the track, and quickly 
pressed the first two LEDs into it. When the glue 
had set, we lifted up a middle LED, applied a little 
glue under it, and pushed that down, then we 
repeated this for the final LED in the strip. You can 
see a full track section in Figure 8 (overleaf). 


LED driver 

As there are so few LEDs on at any one time, 
and they are not shining at full blast, it is safe to 
power them off the 5V pins of the GPIO connector. 
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led_racer.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


© magpi.cc/dhaAam 


0e1. 
0e2. 
003. 
004. 
0e@5. 
006. 
007. 
008. 
0e9. 
018. 
011. 
012. 


013. 
014. 
015. 
016. 


017. 
018. 


019. 


20. 
21. 
022. 


023. 
024. 


25. 


026. 
027. 


028. 
29. 
030. 


Q31. 


Q32. 
Q33. 
034. 
Q35. 
036. 
037. 
038. 
39. 
04e. 
041. 
042. 
043. 
e044. 
045. 


046. 


#!/usr/bin/env python3 

#LED Racer - by Mike Cook June 2019 

# Needs to run in supervisor mode 

# Can take over 5 seconds to initialise 


import os, pygame, sys, csv, time, spidev 
# comment out next line if no LEDs attached 
import board, neopixel 


pygame. init() 

pygame.mixer.quit() 
pygame.mixer.init(frequency=22050, size=-16, 
channels=2, buffer=512) 

os.environ[ 'SDL_VIDEO_WINDOW_POS'] = 'center' 
pygame.display.set_caption("LED Racer") 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame.KEYDOWN, 

pygame .QUIT]) 

screen = pygame.display.set_mode([920,498],, 32) 
textHeight=22 ; font = pygame.font.Font(None, 
textHeight) 

done = False ; trackLEDs = False ; screenUpdate = 
False 

lastPos = [0,0] 

position = [@.0,0.0] # progress of player 

lap = [0,0] ; raceLaps = 1 # number of laps ina 
race 

nAv = 10 # number of samples to average 


avPoint = [0.0,0.0] ; average = [0.0,0.0] 3; speed = 
[0.0,0.0] 

p1 = [0] * nAv_ ; p2 = [2] * nAv 5 runningAv = 
[p1,p2] 


backCol = (180,180,180) ; black = (@,0,0) 
scale = [5000, 4100] # adjust if two controllers are 
not the same 


def main(): 
global position, lap,screenUpdate, done, winner, 
speed 
print("LED Racer - use number keys to set the 
number of laps") 
init() 
initLEDs() # comment out if no LEDs attached 
while 1: 
winner = -1 ; speed[@] = @ ; speed[i] = 2 
position = [0.0,0.0] ; lap[@] = @ ; lap[1] = 2 
drawScreen(@,@) ; time.sleep(2.0) 
whistle.play() 
while not done: 
time.sleep(@.205) 
checkForEvent() 
readVoltage() 
updatePosition() 
if screenUpdate : 
drawScreen(path[int(position[@])], 
path[int(position[1])]) 
updateLEDs(path[int(position[@])], 
path[int(position[1])]) 


047. 
048. 


049. 
Q50. 
Q51. 
Q52. 
Q53. 
Q54. 
Q@55. 


Q56. 
Q57. 


058. 
Q59. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 
75. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 


85. 
086. 
087. 
088. 
89. 


090. 
91. 
92. 
093. 


094. 
95. 


096. 


screenUpdate = False 
drawwords( 
"press space for a new race",350,430,black, backCol) 
pygame.display.update() 
end.play() 
while done: # wait for space bar or quit 
checkForEvent() 


def updatePosition(): 
global position, screenUpdate, lap, lastPos, 
done, winner, speed 
for i in range(@,2): 
position[i] += speed[i] + 
speedChange[ int (position[i])] 
if lastPos[i] != int(position[i]): 
screenUpdate = True 
lastPos[i] = int(position[i]) 
if position[i] >=len(path): 
position[i] = 2 
lap[i] += 1 
if lap[i] >= raceLaps: 
winner = i 
done = True 
speed[@] = @ ; speed[i] = @ 


def updateLEDs(pos@,pos1): 
global pixels 
if(trackLEDs) : 
pixels.fill((@, 8, @)) 
if pos@ == posi: 
pixels[pos1] = (255,0,255) 


else: 
pixels[pos®] = (0,100,200) 
pixels[pos1] = (200,200,0) 


pixels. show() 


def drawScreen(pos®,pos1) : 
screen.blit(track, (0,0) ) 
pygame. draw. rect (screen, backCol, (8, 399,920,99) ,@) 
drawWords("Blue Car", 35,407, (@,10@, 200) , backCol) 
drawwWords("Yellow Car",630,407, (140,140,@), 

backCol) 
drawWords("Lap",35,430,black, backCol) 
drawwWords("Lap", 630,430, black, backCol) 
drawWords("Speed" ,35,450, black, backCol) 
drawWords ("Speed" ,630,450, black, backCol) 
drawwWords(str(raceLaps)+ 

“Lap Race" ,390,4@7, black, backCol) 
drawwords(str(lap[@]), 87,430,black, backCol) 
drawwords(str(lap[1]), 688,430,black,backCol) 
drawWords(str(int(speed[@]*100)), 

87,452, black, backCol) 
drawWords(str(int(speed[1]*100)), 

688,450, black, backCol) 
if pos@ == posi: 

pygame. draw. rect (screen, (200,08, 200), ( 

led_pointX[pos@], led_pointY[pos@],10,12),0) 

else: 


The Squeeze: LED Racer | magpi.cc | 61 


62 


MéigPi 


Use Lego figures, 

farm animals, flags or 
buildings to enhance 
the look of the layout 


Top Tip 


LED fit 


If the LEDs don't 
fit firmly in the 
template and 

pop out, secure 
them in place with 
Blu Tack. 


Figure 8 
A completed 
track section 


magpi.cc 


Therefore, all we need to drive them is a normal 
74HTC14 buffer to step up the 3.3V data signal 
from Raspberry Pi to the 5 V required by the LEDs. 
We have used this circuit many times before when 
we have used addressable LEDs. We managed to 
squeeze this onto last month’s input signal board, 
and the layout of this is shown in Figure 9. 


The base board 

We took a1070 mm by 600 mm piece of 
18mm thick P5 floor boarding and painted it green 
— two coats of primer, two of undercoat, and two 
of top coat — then we laid out the track on it. At 
each side of every other piece, we drilled a3 mm 
hole through the track and board and inserted 
a 20mm M3 screw to fix the track in place - we 
didn’t fasten these down, just the screw pushed 
through both holes alone held it in place. We did 
this one piece at a time, keeping the rest of the 
track in place at all times. 
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Figure 9 Layout of the LED driver and signal conditioner board 


The wiring loom 

The connectors on each track piece now 
need to be wired. The 5V and ground go to each 
section of track; the data flow was shown in 
Figure 1. LEDs 0 to 128 form the outer ring, and 
LEDs 129 to 183 form the extension loop. The 
software controls the order these are lit, so that 
it looks like a continuous track. Most of the track 
pieces have their data-out connected to the data- 
in of the next piece — except for the loop, where 
you connect the data-out of track C8 and connect 
it to the data-in of the Points 1 section. 


The software 

The software to drive this is shown in the 
led_racer.py listing. The path list translates the 
position round the track into what LED is lit. 
Sloping sections of the track, like the bridge, speed 
up or slow down the cars, so you have to squeeze 
mote rapidly to crawl up the hill. With the number 
keys, you can set how many laps a race should 
last. The red and blue cars are represented by their 
colours, but when they are on the same spot it isa 
purple colour. The screen display mirrors the LED 
track, so you could play it without the physical 
track if you wanted. 


In conclusion 

We have another version of this program on the 
GitHub page that imposes speed limits around 
some sections of the curved track. You spin off and 
get a time penalty for going too fast. Also see this 
page for notes on generating your own layout. 
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led_racer.py (continued) 


» Language: Python 


097. 


098. 


99. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 


109. 
110. 
111. 
112. 
113. 
114. 
115. 
116. 
117. 
118. 


119. 


120. 
121. 
122. 
123. 
124. 
125. 


126. 
127. 
128. 
129. 
130. 
131. 


132. 
133. 
134. 
135. 


136. 


137. 
138. 
139. 
140. 
141. 
142. 
143. 
144. 
145. 


pygame. draw. rect (screen, (2,100, 200), ( 
led_pointX[pos@],led_pointY[pos@],10,10),0) 
pygame. draw. rect (screen, (200, 200,02), ( 
led_pointX[pos1],1led_pointY[pos1],10,10),0) 
if winner !=-1: 
screen.blit(flag, (64,122) ) 
if winner == @: 
screen.blit(flag, (145,402) ) 
else: 
screen.blit(flag, (761,492) ) 
pygame. display.update() 


def drawwords(words,x,y,col,backCol) : 
textSurface = font.render( 

words, True, col, backCol) 
textRect = textSurface.get_rect() 
textRect.left = x # right for align right 
textRect.top = y 
screen.blit(textSurface, textRect) 
return textRect 


def readVoltage(): 
global average, avPoint, speed, runningAv 
for i in range(@,2): 
adc = spi.xfer2([1, (8+1)<<4,0]) # request 
channel 
reading = (adc[1] & 3)<<8 | adc[2] # join two 
bytes together 
runningAv[i][int(avPoint[i])] = reading 
avPoint[i]+=1 
if avPoint[i] >= nAv: 
avPoint[i] = 2 
average[i] = 0 
for j in range(@,nAv): # calculate new running 
average 
average[i] += runningAv[i][j] 
average[i] = average[i] / nAv 
speed[i] = average[i] / scale[i] 


def init(): 
global track, flag, led_pointX, led_pointY, path, 
spi, speedChange, whistle, end 
whistle = pygame.mixer.Sound("sounds/whistle.ogg") 
end = pygame.mixer.Sound("sounds/end.ogg") 
track = pygame.image.load("images/Layout. jpg") 
flag = pygame. image. load( 
"“images/flag. png"). convert_alpha() 
path = [] # the sequence of LED numbers to make a 
lap 
for i in range(@,97): 
path. append(i) 
for i in range(129,184): 
path. append(i) 
for i in range(50,129): 
path. append(i) 
#print(‘number of steps in a lap’, len(path) ) 
led_pointX = [] 
led_pointY = [] 


146. 
147. 
148. 
149. 
150. 
151. 
152. 
153. 


154. 
155. 
156. 
157. 
158. 
159. 
160. 
161. 
162. 
163. 
164. 
165. 
166. 
167. 
168. 
169. 


170. 
171. 
172. 
173. 
174. 
175. 
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177. 
178. 
179. 
180. 
181. 


182. 
183. 
184. 
185. 
186. 
187. 
188. 
189. 
190. 
191. 
192. 
193. 


194. 
195. 
196. 
197. 
198. 


x_OfFf = -5 
y_Off = -5 
with open('Points.csv',newline='') as File: 
reader = csv.reader(File) 
for row in reader: 
led_pointX.append(int(row[@])+x_OFfF) 
led_pointY.append(int(row[1])+y_OfF) 
speedChange = [9.0] * len(path) # speed 
increment start off with zero 
# for bridge 
for i in range(22,32): 
speedChange[i] = -@.12 # retarding speed on up 
for i in range(33,43): 
speedChange[i] = 9.1 # increasing speed on down 
spi = spidev.SpiDev() 
spi.open(@,@) 
spi.max_speed_hz=1900000 


def initLEDs(): 

global pixels, trackLEDs 

trackLEDs = True 

pixel_pin = board.D18 

num_pixels = 184 

ORDER = neopixel.GRB 

pixels = neopixel.NeoPixel(pixel_pin, num_pixels, 
brightness=0@.15, auto_write=False, pixel_order=ORDER) 

updateLEDs(@,@) 


def terminate(): # close down the program 
pygame.mixer.quit() 
pygame.quit() # close pygame 
if trackLEDs : 
pixels.fill((@, 8, @)) # turn off LEDs 
pixels. show() 
os._exit(1) 


def checkForEvent(): # see if we need to quit 
global reading, screenUpdate, average, done, 
raceLaps 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.key == pygame.K_SPACE : 
done = False 
if event.key == pygame.K_RETURN : 
done = True # reset a race 
screenUpdate = True 
if event.key > pygame.K_@ and event.key <= 
pygame.K_9 : 
raceLaps = event.key - pygame.K_O 
screenUpdate = True 


if _name_ == '  main_': 


main() 
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GUI user input 
with C and GTK 


Enable users to enter text, and to select 
options using check and radio buttons 


e’ve seen how we can display text ona 
W window using a label — in last issue’s 
tutorial (magpi.cc/83) — but what 


about if we want to read in some text that the 
user has typed? GTK provides the GtkTextEntry 


Siren are widget for this. void main (int argc, char *argv[]) 
is a software { 
engineer working Text entry gtk_init (&argc, &argv); 


for Raspberry Pi, 


responsible for Modify the example code from last issue to adda 

the Raspberry new cell to the table with a GtkTextEntry widget, GtkWidget *win = 

Pi Desktop on like so: gtk_window_new (GTK_WINDOW_TOPLEVEL) ; 

both Raspbian x 

and Debian. GtkWidget *btn = 

nthe #include <gtk/gtk.h> gtk_button_new_with_label ("Close window") ; 


g_signal_connect (btn, "clicked", 


| GtkWidget “txt; CALLBACK (end_program), NULL); 


g_signal_connect (win, "delete_event", 
void end_program (GtkWidget *wid, gpointer ptr) G_CALLBACK (end_program), NULL); 


{ GtkWidget *lbl = gtk_label_new ("My label"); 
gtk_main_quit (); 


GtkWidget *tab = gtk_table_new (2, 2, TRUE); 
gtk_table_attach_defaults (GTK_TABLE (tab), 
1 
INTRODUCTION gtk_table_attach_defaults (GTK_TABLE (tab), 


CsGUI Hus to 2D) 


An Introduction 
toC & GUI | 
Programming 


For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
Cor GTK is required! 

magpi.cc/GUIbook 


gtk_container_add (GTK_CONTAINER (win), tab); 
gtk_widget_show_all (win); 
gtk_main (); 

} 
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Figure 1 atktest oer 
My label Copy button 


A Figure 1 A GtkEntry added to the bottom-right of the table 


In this example, we declare a pointer to the 
GtkTextEntry widget, txt, as a global variable. 
This is because we need to access it from a button 
handler, which also needs to access the GtkLabel 
widget. We previously used the general-purpose 
pointer in the g_signal_connect function to pass 
widget information to a handler, but in this case, 
the handler needs access to two separate widgets, 
and we’ve only got one pointer. (There are ways of 
using a single pointer for this, but using a global 
variable is a lot easier to understand.) 

We’ve added a new function, copy_text — this 
uses the function gtk_entry_get_text to get a 
pointer to the text buffer used by the GtkEntry 
widget; this stores whatever the user has typed 
into the entry box. Note that the pointer to this 
buffer of chars is declared with the modifier const 
— this indicates a variable that cannot be changed 
by the programmer. We then pass this buffer to 
gtk_label_set_text, which copies the contents of 
the GtkEntry to the GtkLabel. 

Finally, we’ve created the GtkEntry itself with 
gtk_entry_new, and added it to the table. (Note 
we’ve also moved the attachment points of btn so 
that it only takes up one cell of the table rather than 
two, so as to give enough space for the GtkEntry.) 

Build the code and run it; try typing something 
into the entry box and pressing the ‘Copy button’ to 
see what happens (Figure 1). 


Spin buttons 
There are various other ways for the user to enter 
data. Quite often they need to select one of a 
number of options, rather than being given a box 
and asked to type into it. GIK provides a number 
of widgets for this purpose; one, which is closely 
related to the GtkEntry, is the GtkSpinButton. 

A spin button is used to enter a numeric value 
in acertain range. You specify the minimum and 
maximum values, and by how much the value should 
change on each press of the button. This gives a text 
entry control — which the user can still type into - 
with an easy way of changing the value. If the user 
does type in a value which is outside the limits you 
set, it is automatically rounded to the closest value 
within the limits when you try to read it. 
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We only need to change one line to convert 
the GtkEntry to a GtkSpinButton in our example 
above. Replace: 


txt = gtk_entry_new (); 
...with: 
GtkObject *adj = gtk_adjustment_new (@, -10, 
10, 1, @, @); 


txt = gtk_spin_button_new (GTK_ADJUSTMENT 
(adj), @, ®)5 


This changes txt from a GtkEntry toa 
GtkSpinButton. We can see that one of the 
arguments to the gtk_spin_button_new function is 
something called a GtkAdjustment — what’s that? 
A GtkAdjustment is used to set the range 
of values that a spin button (and a few other 
widgets with similar behaviour) can take. So the 
gtk_adjustment_new function takes arguments 
which specify, in order, the default value (0 in this 
case), the minimum value (-10), the maximum 
value (10), and the step size (1). (The last two 
arguments specify ‘page’ increments, which are 
used in some controls where there are two different 
sets of buttons to change the values - a spin button 
doesn’t use these, so they can just be set to zero.) 
The GtkAdjustment is passed as an argument to 
the gtk_spin_button_new function. The other two 
arguments are the climb rate — how fast the value 
changes when the button is held down — and the 
number of decimal places to be shown on the value. 
Build and run the new version of the code; the 
text entry box now has two small buttons at the 
right-hand side (Figure 2); these can be used to 
change the value. You can still type into the box; if 
you type a value that isn’t a number, or is outside 


the range specified in the GtkAdjustment, it will be Vv Figure2A 
corrected to a value within the range when one of eee 


these buttons — or ‘Copy button’ - is pressed. the GtkEntry 


Figure 2 


My label 


. | A 
Close window | 0 = 
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Figure 3 


My label 


Close window | 0 


A Figure 3A 
GtkCheckButton 
at the top-right of 
the window 


gtktest 
J |My check 


<I> 


Toggle buttons 

One useful way to get input from the user is by 

the use of buttons to select an option. GTK offers 
several widgets for this purpose; two of the more 
useful are check buttons — boxes that can be ticked 
or unticked — and radio buttons — selectors in which 
only one member of a group can be active at a time. 
These are both children of the GtkToggleButton 
widget, which is itself a child of the GtkButton 
widget we have already used several times; a toggle 
button is a button which can be in either a selected 
or an unselected condition. 


Check buttons 

Check buttons are the simpler of the two, so we’ ll 
look at those first. A GtkCheckButton is a box 
which can either be empty or have a tick mark in it, 
clicking on it toggles it between those two states. 
Creating one is as easy as: 


GtkWidget *chk = 
gtk_check_button_new_with_label ("My check"); 


This creates a check button and a label to its left 
with the supplied text in it. (There is also a function 
gtk_check_button_new, which creates just the 
check box without the label — this makes things 
tidier if you have a label for it somewhere else in 
your window.) Try replacing btn2 in the previous 
example with a check button like chk — it should 
look like Figure 3. 

By default, a check button which has just been 
created is in the unchecked state. To check the 
button, you call: 


gtk_toggle_button_set_active 
(GTK_TOGGLE_BUTTON (chk), TRUE); 


Setting the button’s active state to TRUE checks the 
box; setting it to FALSE unchecks it. 

There’s a corresponding function to read the 
active state of a toggle button. To read whether a 


check button is currently checked into a variable, do: 


66 | magpi.cc | GUI user input with C and GTK 


int state = gtk_toggle button_get_active 
(GTK_TOGGLE_BUTTON (chk)); 


The value of state will be 1 if the button is checked, 
or O otherwise. 

You can also connect a handler to the toggled 
signal of a check button with g_signal_connect 
— this is equivalent to connecting to the clicked 
signal of a regular GtkButton, as we have seen in 
previous examples: 


g_signal_connect (chk, “toggled”, 
G_CALLBACK (check_toggle), NULL); 


The handler for a toggled call looks like this: 


void check_toggle (GtkWidget *wid, 
gpointer ptr) 
{ 
printf ("The state of the button is %d\n", 
gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON 
(wid)))5 
} 


Note that the first argument of any handler callback 
is always a pointer to the widget that generated the 

signal, so we check the state of the check button 
by calling gtk_toggle_button_get_active on the 
pointer received as the first argument to its handler. 


Radio buttons 
Radio buttons can be viewed as a group of check 
buttons, in which one and only one of each group 

is selected at a time - checking any button in the 
group automatically unchecks all other buttons in 
the group. These are shown as circular indicators: 
The code controlling radio buttons is almost 
identical to that for check buttons; their active state 
can be set or checked with the same commands, and 
they generate a toggled signal when clicked. 

The significant difference between radio button 
and check button code is that radio buttons need to 
be assigned to a group of other radio buttons; this is 
required so that the link between the set of buttons 


Figure 4 


gtktest 
©) Button 1) © Button 2 
Close window || 0 * 


A Figure 4 Two GtkRadioButtons at the top of the window 


is established so that GIK knows which buttons 
need to be unchecked when another is checked. 

Radio buttons are created using the function 
gtk_radio_button_new_with_label — this takes one 
additional parameter over gtk_check_button_new_ 
with_label, which is the group to which the button 
belongs. When the first button in a group is created, 
this parameter is set to NULL: 


GtkWidget *rad1 = 
gtk_radio_button_new_with_label (NULL, “Button 1"); 


When second and subsequent buttons are created, 
the group of the first button can be read with the 
function gtk_radio_button_get_group and passed 
into gtk_radio_button_new_with_label calls 


GSList *group = gtk_radio_button_get_group 
(GTK_RADIO_ BUTTON (rad1)); 


GtkWidget *rad2 = 
gtk_radio_button_new_with_label (group, 
"Button 2"); 


M The significant difference 
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between radio button and check 
button code is that radio buttons 
need to be assigned to g group 


of other radio buttons 


Every button in the group needs to be associated 
with another button in the same group in this 
manner in order for the link to work correctly. (Any 
radio button which is not linked with a group will 
not function correctly; it will always be selected and 
clicking on it has no effect.) 
Try replacing the check button and the label in 
the previous example with the pair of grouped radio 
buttons shown above — you should get something 
that looks like Figure 4. 

If you’ve linked them correctly, then when you 
click ‘Button 2’, it will be selected and ‘Button 1’ will 
be unselected, and vice versa. 
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Automatic Active Cooling with PWM FAN speed regulation 
DS1307 Hardware RTC with coin battery 1220/25 

3 System LEDs indicators (Cold, FAN, HOT) 

No installation is needed, not using any additional GPIO 
Additional Temperature Sensor Placed exactly above CPU 


5V/3V 1-wire interface with ESD protection and 2 x User LEDs 


Optionally: Infra-Red Receiver, High Current Relay and Buzzer 
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Full user programmable and CPU core temperature monitor via I2C TECHNOLOGY 
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Take your Raspberry Pi outside for 
some fun making outdoors 
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Hydroponic 
Gardening 


Automate growing 
some veggies 


" 


Zero GPS 
Logger 


magpi.cc/40 


ur colleague Matt Richardson, from 

Raspberry Pi Foundation North America, 

created this little project when Raspberry 
Pi Zero first came out, using a simple GPS 
locator and some code. You can use it to track 
your walks, runs, hikes, bike rides, commutes, 
drives, and more, for analysis later. 

You could easily combine this with one of the 
boat projects, or even a HAB, to get a better idea 
of where you’re going and where you’ve been — 
although it’s probably not quite accurate enough 
for full automation in some cases. 


ns 


< 


MéigPi 


Portable power for outdoor projects 


How do you keep your Raspberry 

Pi on while outside? Well, if you’re 
just powering a Raspberry Pianda 
few small components hooked up 

to the GPIO pins or USB ports, a 
portable battery pack / phone charger 
will do the trick. You can turn off 

the graphical desktop in Raspberry 

Pi Configuration to reduce power 
consumption as well, so that the 
battery lasts longer. If you’ re feeling 
particularly adventurous, you can look 
at an Adafruit PowerBoost and get a 
lithium battery to power your creation. 
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Explore the world beneath the waves 
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RoAcri¢ Fgh AINTOde 
Sallbot Ballooning 


Captain Raspberry Pi sails away 


2 


daveakerman.com 


e talked a bit about HAB (high- 

altitude ballooning) last issue, which 

is essentially where you strap your 
Raspberry Pi to a special balloon and send it over 
30km into the sky. Preferably with a parachute so 
that you can retrieve it afterwards as well! 

Weather is a big factor in making sure it’s safe 

to launch, so a clear day with low wind offers 
optimal conditions to then launch your balloon, 
before chasing it down once it inevitably goes pop. 
Building it is fun as well — you can do it all froma 
Raspberry Pi, including GPS trackers to chart its 
progress, a Raspberry Pi Camera Module to take 
photos and videos of the Earth from up high, along 
with any other sensors you fancy attaching to it. 
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NafOveby7és Nature Trap 


What's living in your garden? 


B 


Easy-to-read monochrome screens 


Traditional screens aren’t always the easiest to 

see in daylight, even on modern smartphones. If 
you’re planning to create something that might need 
a display of some kind outdoors, there are two great 
alternatives: simple black and white LED displays 
such as the GFX HAT (magpi.cc/nZseKc), or an e-ink 
display like Inky wHAT (magpi.cc/LZWpAq). 
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Kasphery Pi Camera 


hone cameras are great, but have you ever built 

your own camera by hand? There are tons of projects 

around that let you build a camera with a Raspberry 
Pi - from stuff like PolaPi-Zero (magpi.cc/hoWDoR) which 
includes a thermal printer for instant photos, to awesome 


infrared photography (magpi.cc/LUjIKX) that creates surreal 


and picturesque images. 
Remember, Raspberry Pi Camera Modules also have video 


and slow-motion modes, and you can even program one to 
take a series of photos and turn them into an animated GIF! 
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CDP Studio is a development platform for industrial control systems, now coming with a free 


version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, l2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 
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Pibow Coupe 4 
and Fan SHIM 


PIBOW COUPE 4 P Pimoroni » magpi.cc/enLWLt >» £9/S9 | FAN SHIM > Pimoroni >» magpi.cc/qZYBWd > £10/S10 


Raspberry Pi 4 layout means new cases, including a new version of the 
famous Pibow. Rob Zwetsloot checks it out, dlong with a cooling Fan SHIM 


COLOURS: 

Rainbow, Red, 

Ninja 

WEIGHT: ne glance at Raspberry Pi 4 and you’ ll 

509g , 0 notice that it looks quite a bit different 
amuadus from your standard Raspberry Pi Model B. 


Since the original Raspberry Pi B+ came out, all 
Raspberry Pi boards have had a standard port 
layout, but with new tech comes new features, 
which is why Raspberry Pi 4 has some extra ports 
and a shuffling around of the USB and Ethernet. 
You can read why the board layout has changed 
in issue 83 (magpi.cc/83); however, it does mean 
you’ ll either need to hack apart an old Raspberry 
Pi case or get a new one. Which is where Pimoroni 


99 x 66 «15mm 


comes in, as it so often does, with the new Pibow 
Coupé for Raspberry Pi 4. 

Currently the Coupé is the only case style that 
Pimoroni is making for Raspberry Pi 4, lacking the 
top layers of a full Pibow. However, it still partially 


A. The latest Pimoroni 
Pibow Coupe 
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A The Fan SHIM is very small but pretty powerful 


covers and protects a Raspberry Pi 4 while giving 
full access to the GPIO and ports. It also comes with 
a bonus feature: the ability to add a special fan to 
help keep your Raspberry Pi 4 nice and cool. 


Treasure box 

Construction of the case is simple. There are five 
numbered slices of plastic that slot on and around 
Raspberry Pi 4, which are then tightened with 
some plastic nuts and bolts. We were able to put 
it together in a couple of minutes; if you’re 
having trouble, however, there’s a handy 
online build video from Pimoroni. 

If you’ve ever had a Pibow case, you 
know the score — it’s sturdy, light, and 
looks pretty nice. Importantly, it keeps 

a Raspberry Pi protected pretty well from 
dust, grubby fingers, and other environmental 
hazards. The top plate labels what each input/ 
output port is, which is especially handy with the 
shuffles and additions for this hardware release. 
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Os D ecific care has been Specific care has been taken to keep the ih Thecsbs desaiialiowe 
or easily aaain ie 
important chips open to the air, allowing for better Fan on : 


taken to keep the important ventilation of the board. While you don’t need any 
ch DS open to the q ir og special heat sinks or fans for Raspberry Pi 4, it 


doesn’t hurt to add them, and the Pibow Coupé is 
specifically designed to fit the new Fan SHIM. 


2@@ Biggest fan 
@@eeees Again, assembly is simple. Screw the fan onto the 
|" | » Oe PCB, plug it in, then you can slip it over the GPIO é 
Fee : pins while your Raspberry Pi is off. Quick and easy. Ve rd | ct 


However, you will need to install some software to 
control it, which is where it gets really fun. 

Very basically, the software lets you turn the fan 
on and off. However, with different scripts, you 
can have it activate at specific temperatures and 
even change what the LED and button do. It’s very 
hackable and, according to tests, very effective as 
well. It also doesn’t sound like a hoover, which is 
always a bonus with a case fan. 

Raspberry Pi computers have been around for 
over seven years now, and Pimoroni making a nice 
case for one is hardly a shocker — however, it’s nice 
to see that the first round of Raspberry Pi 4 cases /10 


A The Fan SHIM is very small but pretty powerful are great. | 


A great first case 
for Raspberry 

Pi 4, keeping it 
very accessible 
for tinkering 

and hacking. The 
optional Fan SHIM 
is ideal for cooling 
it during periods of 
high CPU load. 
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Keybow MINI 


KEY 


SWITCHES: 

3 x Kailh Speed 
(Gold - clicky, or 
Silver - linear) 


LIGHTING: 
3 x APA102 
RGB LEDs 


BREAKOUT 


HEADER: 
FC, SPI 


DIMENSIONS: 
68.5 « 31.75 « 
39mm 


Verdict 


Considerably less 
expensive than the 
full-size Keybow, 
with the same 
functionality, just 
fewer keys. It 
looks cool when 
lit up, features a 
nice key action, 
and has multiple 
possible uses. 


8, 10 
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A mini mechanical keypad with light-up keys. By Phil King 


oney, I shrunk the keypad. The Keybow 
+ MINI is a three-key version of the original 

12-key Keybow reviewed in issue 79 
(magpi.cc/79). This time you need to supply your 
own Raspberry Pi Zero (with a GPIO header), but 
otherwise the principle is the same: connect the 
keypad to another computer — with the supplied 
micro USB to USB-A cable — and you can customise 
the key mapping to use it for a wide range of 
purposes, such as a games controller, hotkey pad 
for applications, or to insert text/code snippets 
with a single key press. 

Solderless assembly is very similar to the 
original Keybow and only takes 10-15 minutes. 
After attaching your Raspberry Pi Zero to the 
PCB and acrylic base, you simply push-fit three 
switches into a key plate (making sure they’re all 
orientated the same way) and add the translucent 
key caps before slotting into the PCB. 

As before, you’ I need to supply your own 
microSD card for the tiny (26.6MB) Keybow OS. 
Upon connecting the Keybow to a computer via the 
USB OTG cable, the OS is loaded into a RAM disk 
and it boots up in just 10-15 seconds. 


A You have the choice of clicky or linear (quiet) keys 


A The keys can be lit up in static or animated patterns 


Unlike with the full-size Keybow, we had no 
problem inserting the cable into Raspberry Pi Zero’s 
USB OTG port as the latter is now situated on the 
edge of the device rather than tucked away inside. 


Light it up 
Once connected, the keys light up in an animated 
rainbow pattern (determined by a PNG file). To 
change this, and customise the key mapping, 
you need to slot the microSD card back into your 
computer and edit a Lua file to select a sample key 
layout or your own custom one, as explained in 
the online tutorial: magpi.cc/WdAWZc. As noted 
there, you do need to add a few lines to the default 
Keybow layout code, and alter some function 
names, to make it work on the MINI. Alternatively, 
there’s now a Keybow Python library that can be 
used within Raspbian to light and map the keys. 
Either way, the real power of the Keybow MINI 
lies in the ability to create advanced macros to 
trigger a whole series of key combinations and 
presses with just a single key press. 
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10 Best: 


Projects to 
upgrade with 
Raspberry Pi 4 


Raspberry Pi 4 is very powerful, and aRetro Games Console 
extremely fast. Here are some projects 


you could upgrade with one... 


Emulation station 


Early tests have shown far better emulation of fifth-generation video game 
consoles. At the time of writing, the RetroPie team are hard at work on a version 
henever a new Raspberry Pi model comes of their excellent retro gaming OS for Raspberry Pi 4. 
out, we end up dreaming about what we 
can do with it. Raspberry Pi 4 is no different, 
especially with all the extra power it has! Here are ten 
excellent Raspberry Pi projects that would be made so 
much better with a Raspberry Pi 4. H 


magpi.cc/newpicade 


<Pi-hole 


Ad-blocking for extra security 


We hear about people using Pi-hole all the time, 
especially with the amount of malicious and 
suspicious ads that exist on the internet these days. 
This blocks these ads before they even get to your 
computer - and with improved networking speeds, 
Raspberry Pi 4 makes this even better. 


pi-hole.net 


> Robots 


Powered-up automatons 


a Fi le Server There are many pros in using a 


Raspberry Pi 4 as your robot's 
brain: the faster processing 
speeds and improved network 


Network storage 


A lot of folks already have a Raspberry Pi file server in their connection makes for better 
homes. Their size and low power footprint make them perfect control, whether by a remote 

for the task. The only issue with them has been networking and or code. However, it does eat 
storage bottlenecks, due to USB 2.0 and 100MB Ethernet. Now, a bit more power than previous 
with super-speed USB 3.0 ports and proper Gigabit Ethernet, Raspberry Pi models, so consider 
Raspberry Pi 4 will give any file server a big speed boost. what your needs are. 
magpi.cc/samba magpi.cc/QCZsyp 
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v Desktop Replacement 


Ditch Windows and Mac 


Raspberry Pi 4's extra power means it can adequately act as a desktop 
replacement. Especially with the two micro-HDMI ports for dual displays. We'll 
be doing a proper test of this in a future issue, so Look out for it! 


magpi.cc/hDYcvr 


4 Media PC 


Raspberry Pi on telly 


Putting Kodi on a Raspberry Pi is a time-honoured tradition, whether 

it's via LibreELEC, OSMC, or another dedicated media OS. It's 

already pretty great, so how can Raspberry Pi 4 make it better? 4K 

a H.265 hardware decoding is how. This means 10-bit videos will play 
ene properly, and 4K video is possible. Even if you don't have anything like 

Peri that to play, the better networking is sure to help. 


libreelec.tv 


Wireless Bridge v Laptop Pi 


Share some internet z 
Portable Raspberry Pi power 


At an older hotel that only provides internet via an Ethernet cable? Fancy 


being a bit more secure on an open network? Using a Raspberry Pi 4 as a If Raspberry Pi 4 can be a desktop replacement, it call also bea 
wireless bridge means you'll get a much faster internet and general network laptop replacement. Custom Raspberry Pi laptop builds can be a bit 
connection in this case. tricky, but as Raspberry Pi 4 has largely the same design as previous 


Raspberry Pi models, you should be able to easily replace older ones. 


magpi.cc/LhVfpE . 
magpi.cc/awpkvX 


v Machine 
Learning 


4GB of artificial intelligence 


More power and better network 
speeds mean you'll have a much 
better time using something like 
OpencCV for computer vision, or 
connecting with any number of 


~ Supercomputer online APIs to do some image or 


Cluster voice recognition. 
magpi.cc/YKzcLp 


Parallel computing 


Beowulf clusters made with 
Raspberry Pi are pretty cool for big \ | . 
maths problems and other number- Pat bo |W _~ \ari aS Erie 


crunching tasks. With about three SPECS AND BENCHMARKS \" 


to four times more raw processing 
power in Raspberry Pi 4 than 

Want to see just how good Raspberry Pi 4 is? Check 
out our full specs and benchmark breakdowns in 


Raspberry Pi 3B+, you'll be able to pull 
off some amazing calculations. 
issue 83 of The MagPi (magpi.cc/83) 


magpi.cc/VhUiPc 
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MM Magri | RESOURCES 


Learn Sense HAT — 
with Raspberry P1 


Essential resources for the space-borne add-on board for Raspberry Pi, By Lucy Hattersley 


Astro P1 Resources 


Astro Pi The Sense HAT is an add-on Raspberry Pi units were sent 
board for Raspberry Pi. It into space). 

Price: adds a range of motion sensors Astro Pi is an ESA (European 

Free to Raspberry Pi, including a Space Agency) project run with 

astro-pi.org/resources — gyroscope, accelerometer, the Raspberry Pi Foundation. 
and magnetometer, plus It enables young people to 
temperature, pressure, and conduct scientific investigations 
humidity sensors. On top of the in space by writing computer 
Sense HAT board sits an 8x8 LED programs thatrunonRaspberry Code Club (codeclub.org) and 
matrix and five-button joystick. Pi computers aboard the mentoring students. 

Sense HAT is a lot of fun. It’s International Space Station. Even if you don’t want to take 

a great way to get feedback on Students up to 19 years old part, Astro Pi has a solid set 
an environment with Raspberry _ can take part. If you’re older of resources designed to help 
Pi, and was made especially for than that, you can still get students set up the Sense HAT 
the Astro Pi mission (where two involved by volunteering for a and collect data from it. 


Video Learning 


Set up the Sense HAT by watching a video 


ASTRO PI KIT - HOW TO rigours of space flight. Discover how to 
ASSEMBLE THE SENSE HAT 3D-print your own special Astro Pi case 
This video from the ESA takes you in this video. 


through setting up the Sense HAT ona magpi.cc/axKOOB 
Raspberry Pi and using it to take part in 


the Astro Pi project. TIM PEAKE WITH ASTRO PI ON 
magpi.cc/uriDhA THE INTERNATIONAL 

SPACE STATION 
HOW TO BUILD A 3D-PRINTED Take a tour of the ISS and the Sense 
ASTRO PI FLIGHT CASE HAT kits being used on board the 
The Sense HAT units used in the space station with British ESA astronaut 
Astro Pi program are housed inside Tim Peake. 
special cases designed to endure the magpi.cc/dacYpU 


Image credit: ESA 
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Getting Started 


with Sense HAT 


Raspberry Pi 
Foundation 


Price: 
Free 


rpf.io/ projects 


If you’re looking to get up- 
and-running with Sense HAT, 
the Raspberry Pi Foundation 
has you covered. The Getting 
Started with the Sense HAT 
tutorial (magpi.cc/QBynLN) 
shows you how to display text 
and images on the LED matrix 
display, set the orientation, 
and sense the environment 
and movement. 

After that, head over to the 
Raspberry Pi Foundation’s 
projects website, click ‘Browse 


all projects’, and change the ‘Any 


hardware’ drop-down to Sense 
HAT (magpi.cc/FCCwsc). Here 
you’ ll find a range of fun projects 
that explore all the different 
elements of the Sense HAT - 
from building a tight-rope game 
controlled by the accelerometer, 
to a weather logger and rainbow 
predictor. The projects are 
sparkly and designed to appeal 
to kids, but they’re a great way 
to learn data capture and basic 
programming concepts. HI 


Experiment with 
the Sense HAT 


Raspberry Pi 
Education Team 


Price: 
Free 


magpi.cc/ 
sense-hat-book 


Essentials Guides are short 
books designed to make it easy 
to learn Raspberry Pi subjects. 
One of the most popular and 
enduring is Experiment with 
the Sense HAT. 

You can still pick up a digital 
copy of this book for free, 
although print copies are now 
hard to find. 

Inside the book, you’ ll find 
eight chapters that cover 


everything from setting up the 
Sense HAT to building projects 
such as a Magic 8 Ball and 
Interactive Pixel Pet. 

While the Astro Pi mission 
has evolved beyond that 
described in the book, the 
tutorials have stood the test 
of time. They remain a great 
way to understand the inner 
workings of the Sense HAT and 
how to control it with code. 


RESOURCES | Magri [a 


resources 


Get the most from 
your Sense HAT 
with this online 
documentation 


SENSE HAT API 

Make sure you bookmark 

the Sense HAT API webpage. 
This reference outlines all the 
functions used to control the 
HAT (and used in a variety of 
different tutorials). 
magpi.cc/cDbEPq 


SENSE HAT GITHUB 

Take a look at the Python 
module used to control the 
Sense HAT hardware on 
Raspberry Pi. Here you will 
find the underlying code being 
used to control the device. 
magpi.cc/fOtNFp 


SENSE HAT 
DOCUMENTATION 

Raspberry Pi documentation for 
the Sense HAT explains how to 
set up and calibrate the device, 
as well as update the firmware. 
Check out the link to the 
schematics while you're there. 
magpi.cc/fNqSCn 
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WE Magri | INTERVIEW 


Anne 


arlill 


Veteran programmer and founder of York Raspberry Pi Jam 


> Day job Retired | >» Community role Raspberry Jam runner | > Website magpi.cc/YVgvmU 


44 ork is a small city but I 

Y felt it had potential to 
have a regular Jam,” 

Anne Carlill explains to us. For 
those outside of the UK, York is 
a historic city, even if it is a little 
small, and a symbol of the North 
of England. 

Anne herself definitely has 
the know-how to run a Jam in 
York. She’s been coding for 45 
years, passing on her skills to 
her children with a BBC Micro 
in the eighties. She’s also been 
a college teacher, and now, 
although she’s retired, she has 


been running a Code Club for 
four years. 

“There had been a couple of 
big Jams at the STEM Centre 
but no follow-up,” Anne 
continues. “I’ve been going to 
Leeds Raspberry Jam for about 
four years and have learnt so 
much from their organiser 
Claire Garside — and it was 
Claire who suggested I should 
consider running a Raspberry 
Jam. I went to Cambridge for 
the training, took a while to find 
venues, and started running my 
own at the beginning of 2017. I 


think of YRJ as a little offshoot 
of Leeds, as our attendance is 
small, but we are growing. York 
Explore Libraries have been 
very supportive and both of our 
venues are libraries: one in West 
and one in East York.” 


What are the York Raspberry 
Jam attendees like? 

They are all ages and abilities, 
but mostly parents with children: 
they’re beginners right up to 
people who know a lot more than 
me. Luke (@YorkPiJam) and I 
began organising together in 
March 2018. It’s a bit odd having 
a 16-year-old and a grandma, in 
her late 60s, planning together, 


A Luke runs the Jam with Anne - you 
may have seen him in the magazine 
writing tutorials in the past 


> Learning Minecraft 
Pi seems to still be 
popular everywhere 
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but it works. We plan by social 
media as we don’t see each other 
between Jams. Luke is the brains, 
and I’m the facilitator who makes 
sure the kit works and there are 
biscuits, etc. 


really taking to the Raspberry Pi! 
And I’m very keen to know how 
well Raspberry Pi is going down 
in places like India and Africa 
where the cost really matters. 

I love hearing from people in 


M What excites me most is to see 
people who haven't got much cash 
really taking to the Raspberry Pi! @ 


How did you learn about 
Raspberry Pi? 

I heard a report on the Radio 4 
Today programme about six years 
ago and just had to have one. My 
Model B setup cost £60 and I have 
about £20 a month to save up or 
spend on electronics kit. What 
excites me most is to see people 
who haven’t got much cash 


those places about what they’ re 
managing to do with their frugal 
kit of Raspberry Pi devices. 


What have you made with a 
Raspberry Pi? 

l’ma beginner with physical 
computing, but I really enjoy 
having a go. I’ve made the 
CamjJam EduKit #3 robot buggy 


and several light-up wearables. 

I think my best project so far 
has been the My Naturewatch 
Camera Trap, though, because I 
was given a Raspberry Pi Camera 
Module a few years back and 
didn’t know what to do with it. 


Then I heard about this Raspberry 


Pi Zero project, I just had to have 
a go — and it works! So far, my 
pictures have been rubbish, but 
I’m determined to persist. 


Any Raspberry Pi projects 
you’d love to make? 

I’m really keen on the 
environment and looking at 
climate change, so I’d love 

to get a full environmental 
monitor, such as the Enviro+ 
with particulate matter sensor, 
because I’d love to do some 
citizen data science and be part 
of a large-scale data project. Hi 


INTERVIEW | Magri Sa 


York Pi Jam was one of the 
many Raspberry Jams that 
celebrated Raspberry Pi's 

seventh birthday this year! 


York Pi Jam 


Want to check 

out York Pi Jam? 
Keep an eye on the 
Eventbrite page for it 
to find out when new 
Jams are planned: 
magpi.cc/YvgvmU. 
They will also be in 
our Events list on 
page 90 when they're 
coming up. 
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ME Magi | THIS MONTH IN RASPBERRY PI 


his Month in 
aspberry P1 


aspberry P1 4 
in the wild! 


Last month, Raspberry Pi 4 was released - here's 
some of the cool stuff we've seen with it so far! 


an you believe it’s only been a month ~ 

C since Raspberry Pi 4 came out? Hopefully aioe oeny EOE = 
everyone that wanted it has managed to grab = Be: 

one by now. However there are still plenty of people The new @ Raspberry Pi with @ pimoroni 

case. Looks absolutely beautiful! 


#RaspberryPi4 


that have already been making amazing things with 
their new Raspberry Pi. Hl 


01. People were very happy to get their 
Raspberry Pi 4 computers 


02. Gavin Stephens wasted no time putting 
his Raspberry Pi 4 boards in a cluster 


03. Raspberry Jams are already getting im 
Raspberry Pi 4 computers in to ANN) 
play with! CD) auton 


04, That's one way to play your own music 
in your car! 


05. Some folks flexed their 3D printing skills 
to do stuff like this VESA mount 


06. The desktop replacement Raspberry 
Pi 4 devices are already out there! 


07. Reddit user xCP23x took some amazing 
X-ray photos of Raspberry Pi 4! Check 
them out here: magpi.cc/pDHhTC 
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MéigPi 


mt Gavin Stephens eas ~ James Preece (MOJFP) C rete) 


Sorry for taking down twitter, but | had to @EghamJam had a good time this afternoon 
move this guy into the garage with his bigger satis Sipenacsing lesson amet diepiay 
brothers. #RaspberryPi4 @winkleink thank you as always and got to 


see @MrTomsWorld few @astro_pi 
certificates handed out! #raspberrypi4 
#raspberrypi #makers @FSNetworksEMEA 


| he 


Martin Fasani (sponser ) 


|  #raspberryPl4 is powering also the playlists of 
my car. Working quite stable with cheap 5v 
USB converter max. 2.5 ampere 
i cas Heliacan Ww 


i: 


& Gavin Stephens ( es ) ; S Nick O'Leary 


#RaspberryPi4's running #k3s with #openfaas Created a VESA mount for my 
aeeiag : ‘ From cad in blender to done in under 20 
sitting in their new home. Amazing how easy 3 : ; : 
. minutes. The benefits of having a 3d printer 
the setup of all this was, but | have lots more 


on hand. 


to do 


| took some high-resolution X-ray radiographs of my Pi 4 - Behold! 
xCP23x 6 O2E 


Running a as my main work 
machine this week. Super impressed so far!! 


% Arts 


imgur 
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MagP1 
Monday 


Amazing projects direct from our Twitter 


01. 


02. 


03. 


04. 


05. 


This is an extremely 
impressive bit of 
coding that gets a 
robot to charge itself 
ike a Roomba 


A 200-mile radius is 
pretty incredible for 
his kind of device 


Even doing something 
as simple as traffic 
ight LEDs is a first 
step for someone 


Programming games 
is always fun on 
Raspberry Pi 


A solar-powered 

aawn-mowing robot? 
Look out for more on 
his in a future issue.. 


very Monday we ask the question: have you 

made something with a Raspberry Pi over 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. Here is a small fraction of them. 


Follow along at #MagPiMonday. HI 


T Alan McDonley 


#RaspberryPi #GoPiGo3 #Robot Finds 
Recharge Dock 


@ David Pride c=) 


TheMagPi 


Found my PiAware ADS-B set up in the loft so 
took it out for a drive.. Approx 200 mile 
range. Not bad for a tv dongle & some 
chopped up co-ax cable! 7¢ @Y¥ 


and Staging Point 

using #PiCamera, #OpenCV, a priori 
#Reasoning, Sector Scan Laser Time of Flight 
Distance Sensor, #Trigonometry, #Python3, 
and #numpy. 


Q Odie Odie 


@TheMagPi 


My traffic light using python 


Follow 


@ Just Glowing a 
\ 


Yup, on Pi with with @tic_computer 


111,104.06 


as 
y, 


88 | magpi.cc | MagPi Monday 


TheMagPi 


| improved the drive control of my Raspberry 
Pi based lawnmower robotics project. 


#make your own #3dprinted #loT #smart 
#robotics #lawnmower. 


THIS MONTH IN RASPBERRY PI | Mag?i 


LYRA 


This very slim and lovely-looking handheld console uses 
a Raspberry Pi Compute Module, which helps it stay quite 
slim. It sports a D-pad, four face buttons, and a couple of 
shoulder buttons, which is enough to play pretty much 
every game made before 1995. You can even get a 
cheaper DIY kit so you can have fun building it yourself. 


kek.st/2Jih2r4 


Portable Retro 
Game Console 


Another portable games console! This one 
uses a Raspberry Pi 3A+ to keep it slim, and 
also includes a few more input buttons 
and a more colourful design. It has a much 
larger screen, at 7.9 inches, which is a lot 
bigger than even the Wii U gamepad. 


kck.st/2IPBDCL 


Best of the rest! 


Here are some other great 
things we saw this month 


f i 


SD CARD FIX 


From USD$49.99 Only 
‘Broken SD card slot? Not anymore!’ While 
it's a clever fix, every engineer we showed 
it to made many uncomfortable noises. 
Now you have to look at it as well. 


> magpi.cc/ZLXFDT 


Most convenient DAC for Pi 
No compromise in Audio Quality 
e 192kHz Sampling Rate / 24bit Resolution DAC 


2 x Precise Crystal as master clock for lower jitter 
Ultra low noise voltage regulator 


RASPBERRY PI NETBOOK 


Are netbooks still a thing, or did tablets Up to 1.5" OLED Colour Display 


effectively replace them? Either way, we do 
love a good laptop conversion project, and 
this one using an old portable DVD player 
and a Raspberry Pi Zero is pretty spectacular. | 


Power switch with graceful shutdown 
Full integration with Volumio 
Open’source software on github 
Optional Case, Amp, CD Upsampling 
& Extraction Add-ons 


> magpi.cc/SFqcgS 


http://nanomesher.com/nanosound 


MN Magri | EVENTS 


aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. Hythe Library Jam Summer Coding Session 


© Tuesday 30 July 

9 Hythe Library, Hythe, UK 

> magpi.cc/jetzUj 

Amorning of amazing coding! Design cool games and 
take part in a Summer Reading Challenge coding mission. 


02. Exeter Raspberry Jam 

© Saturday 3 August 

9 Exeter Library, Exeter, UK 

> magpi.cc/MExQAp 

A monthly meeting for everyone interested in all things 
microcomputers, microcontrollers, robotics, and making. 


03. Seattle Raspberry Jam 

© Wednesday 21 August 

9 Bellevue Library, Bellevue, WA, USA 

> magpi.cc/NvsBzz 

Come and participate in the monthly project, share your 
knowledge, or show a project you've created. 


04. Scratch Conference Europe 

© Friday 23 August to Sunday 25 August 

9 Churchill College, Cambridge, UK 

> magpi.cc/PAsskt 

Hosted by the Raspberry Pi Foundation, this event will 
have loads of exciting activities to do and talks to attend. 
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05. Preston Raspberry Jam 


© Saturday 31 August 

Q Fulwood Library, Preston, UK 

> magpi.cc/utJqiR 

A Saturday morning digital making event, with children, 
adults, and families, from beginners to experts. 


06. Stafford Raspberry Jam 

© Tuesday 10 September 

Q Stafford Library, Stafford, UK 

> magpi.cc/hRUXcz 

Welcoming anyone who wants to show off their 


FULL CALENDAR 


Get a full list of upcoming 
events for August and 
beyond here: 


rpf.io/jam 
projects, or see other people's builds! 


07. Roanoke Raspberry Jam 

® Saturday 21 September 

Q Roanoke South County Library, Roanoke, VA, USA 
> roanokeraspberryjam.info 

Join in the digital making community at the Roanoke 
Raspberry Jam hosted by the South County Library. 


08. Castro Valley Jam 

© Saturday 5 October 

Q Castro Valley Library, Castro Valley, CA, USA 

> magpi.cc/eXpRiF 

If you're interested in coding and want to learn about 
Raspberry Pi in Castro Valley, check out this Jam. 


EVENTS | MagPt [a 


@ a FIND OUT 


& ABOUT JAMS 

y 6 Fd ae 8 & 8 Want a Raspberry Jam in 

a e g® é your area? Want to start 

one? Email Tom Hadfield 

6 6 & & about it: 
& . ® jam@raspberrypi.org 
5 ws J 
% %, 
s 


6 


so hum? 
res) We've highlighted some of the areas & 


in need of a Jam! Can you help out? Raspberry Jam advice: 
Activities 


| ‘WY hen a competition like Astro Pi, ora 
programme like Pioneers comes out, 
we’ll do talks and invite people along to 

take part in workshops at the Jam. It’s good because 

it gives an incentive for people to come along and 

take part, and gives them motivation to work. We 

celebrate the entrants, and those who’ve won, 

and invite them to do talks. We ask them 

to mentor at future Raspberry Jams, or 

run workshops.” 


Andy Melder - Southend Raspberry Jam 


Every Raspberry Jam is entitled to apply fora 
Jam starter kit, which includes magazine issues, ‘$: 
printed worksheets, stickers, flyers, and more. SUIDEBOOK 

Get the book here: magpi.cc/2q9DHfQ 
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Your 


Letters 


Past issues 


If I subscribe in print from the 
USA, will I get access to the 
previous issues online? Do I 
get access once I set up the ‘My 
Account’ section? 


Every issue 

free PDF fro 
magpi.cc/is 
able to get t 


Daniel vic email 


is available as a 
m our website at 
sues, so you’ ll be 
hem even if you 


don’t have a subscription! Just 
find the magazine or book you 
want to read, and click on it to 
find out more. 

The My Account section allows 
you to manage your subscription, 
as well as input some payment 
and address details in case you 
make further purchases on the 
Raspberry Pi Press Store. It’s 
just a way to make it easier for 
our users. 


Contact us! 


> Twitter 
@TheMagPi 


> Facebook 


magpi.cc/facebook 


> Email 
magpi@raspberrypi.org 


> Online 
raspberrypi.org/forums 
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ISSUE 83 BEGINNER'S 
JUL 2019 GUIDE V2 


° 
© , 
> i ie 


ISSUE 82 
JUN 2019 


ISSUE79 COMMAND 

MAR 2019 LINE 2 

= 
= 


0060 


StARCH 


ISSUE 81 C&GUI 
PROGRAMMING 


ISSUE 80 
APR 2019 


A Make sure to check out our catalogue page for any old issues you wish to read as a PDF 


I love The MagPi and always 
eagerly await my copy in the 
post every month. However, 
different article authors seem 
to have different opinions about 
the best way to run a script 

(say a Python program) when 

a Raspberry Pi boots. I will be 
needing to run a script on boot 
for the first time for my Times 
Square New York project, and I 
was wondering how best to do 
that, as some say you should 
add a line to crontab, some say 
to add a line to /etc/rc.local, 
some say to add a line to 
/etc/profile. I would like to know 
the best way to run a script on 
boot — The MagPi’s verdict. 


Jonathan vid email 
The reason you see us do it a few 


different ways is mostly down 
to personal taste, and a bit to do 


with the kind of project people 
are making. 

The two best methods in our 
opinion are using /etc/rc.local 
and /etc/profile. The former 
is considered best practice, as 
it makes the script part of the 
startup of Raspbian, so should 
not have as much effect on 
the way you use a Raspberry 
Pi otherwise. The official 
documentation on rc.local 
covers how to do this: 
magpi.cc/SmPEZY. 

The profile method is quick 
and dirty, although it generally 
achieves the same results. While 
both are good if you’re using a 
headless Raspberry Pi setup (i.e. 
no monitor or need for a desktop 
environment), the rc.local 
method lets you dial into a 
Raspberry Pia little more cleanly. 

Give both a try and see what 
works for you! 


Hello, Iam a fan of The MagPi and 
would like to suggest something 
to put in The MagPi! Since 
Raspberry Pi 4 has 2GB of RAM 
and 1.5GHz of processing power, 
this unlocks more opportunities 
for new and more resource- 
hungry operating systems. A good 
idea for ‘The Big Feature’ ora 
cover feature would be the top ten 
operating systems for Raspberry 
Pj 4! And maybe a tutorial on how 
to install some of them! If this 
does make its way into The MagPi, 
please include Android as one of 
these operating systems. 


Joseph vig email 


We’ve done this sort of feature 
before, testing out all the available 


operating systems for Raspberry Pi. 
However, we’re overdue an update 
and Raspberry Pi 4 is a good reason 
to do anew one at some point. 

Unfortunately Raspberry Pi 4, 
while it is more powerful (and can 
have up to 4GB of RAM!), can’t 
just have any operating system 
installed on it. They need to be 
specifically made for Raspberry 
Pi 4 as it has an ARM processor and 
not an x86/x64 processor like a 
standard PC. So while we’ll try out 
as many operating systems as we 
can, we won’t be able to check out 
full Windows 7 or 10, etc. 

As for Android, that’s up to 
Google! We would love to see it 
on Raspberry Pi 4, and we’d be 
more than happy to test it if it 
gets ported. 


MéigPi 


I’m looking forward to seeing 
how Dave Akerman’s Apollo 
anniversary flight goes in this 
issue! I’ve been wanting to get 
into high-altitude ballooning 
myself, and it’s inspiring me 
to look into it! 


Stella via Facebook 


Dave’s Apollo anniversary 
balloon launch was due to 
happen just as we were going 
to press, so we don’t have any 
amazing photos of it quite 
yet — please look out for them 
in the next issue! Dave has 
even created a custom Apollo 
Guidance Computer (AGC) 
display for this special launch 
(magpi.cc/ethRqK). 


ly 's 
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Sound up your 
Raspberry Pi 


Code Club is a network of volunteers and 
educators who run free coding clubs for 
young people aged 9-13. 


We're always looking for people with coding skills to volunteer to 
run a club at their local school, library, or community centre. 


You can team up with friends or colleagues, you will be supported 


by someone from the venue, and we provide all the materials 
youll need to help children get excited about digital making. 


To find out more, join us at 


www.codeclubworld.org 


COMPETITION | Magri 


ne of three 


RASPBERRY PI 4 
Desktop Kits 


The full Raspberry Pi 
Desktop Kit includes Just 
about everything you need 
to use a Raspberry Pi 4! 
Along with a Raspberry 


taspberry Pi 


Pi 4 itself, it comes with a ~tp 
power supply, two micro- < 
HDMI to HDMI cables, & 


16GB microSD card, case, 

keyboard and mouse, and 
Our 252-page Raspberry Pi 
Beginner's Guide. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/hDYcvr 


Terms & Conditions 


Competition opens on 24 July 2019 and closes on 29 August 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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coded Canlstarta 


CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


incredibly 
rewarding experience 


“| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.” 

- Maroes, CoderDojo NL 


Start your own club. Join us at CoderDojo.com 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 oe : 
and is part of the Raspberry Pi Foundation, UK registered charity 1129409 Pee Raspberry Pi 
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The joys of making jam 


For PJ Evans, running a Raspberry Jam is more about the people than the computers 


is stacked with boxes. It’s mostly 

paperwork, stationery, computers, 
and some rather tempting cookies. 
Tomorrow, my wife and I will be up 
early to head to The National Museum 
of Computing, where we will hold the 
next Milton Keynes Raspberry Jam. 
This will be the ninth meet I have 
supervised, although the history of 
the MK Jam goes right back to the 
start, Peter Onion founding the event 
shortly after the launch of the original 
Raspberry Pi. 


[ t’s Friday night. The kitchen table 


here; without their dedication, there 
would be no event. Now we’re a team 
with a common goal that reminds me 
of Lord Reith’s mandate for the BBC: 
inform, educate, entertain. 


Enthusiasm abounds 

Attendees always start arriving 

before we’re ready. I don’t mind: it’s 
fantastic that people can’t wait to get 
started. Projects are set up, workshops 
get booked, and the number of curious 
children are matched only by the 
robots that are now scuttling by our 


M Younger kids squeal with delight as Zobbie 
the robot springs into life @ 


As usual, ma bunch of nerves. 
Will people show up? Have we 
remembered everything? Will the 
attendees like it? Every Friday before 
the Jam, I’m convinced we are heading 
for an embarrassing failure. 

Saturday comes. We arrive ata 
sleepy museum and start erecting 
tables and putting up posters. One- 
by-one the volunteers arrive and my 
fears quickly dispel. Smiling faces, 
full of enthusiasm, travelling far and 
giving up their time for free to make 
this event work. I’m just the caretaker 
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feet. An hour in, our four rooms are 
full to bursting. Electronic noises, 
flashing LEDs, and wide, curious eyes. 
With everyone settled, it’s about now! 
can pause and take it all in. 

This is the good bit, the part 
where I remind myself why we do 
this. A sea of people engaging with 
technology. Some learning, others 
sharing knowledge. Younger kids 
squeal with delight as Zobbie the 
robot springs into life, and partners 
who have patiently accompanied 
their geeky other-half get drawn in 


and start asking questions. At the 
rear of the main room, a group of 
retired engineers are busy sharing the 
progress of their latest projects. 


Great leveller 

Afterwards, we head off for a debrief 
lunch and reflect how Raspberry 

Jams are communities. We get the 
opportunity to inspire young people 
and help them start their journeys 
into technology. There are also those 
retirees who get to indulge their 
passions with like-minded people who 
have become friends. For me, that’s 
what Raspberry Pi is all about. The low 
cost and openness makes it a great 
leveller. There is rightly a lot of focus 
on Raspberry Pi in education, but it’s 
also brought people together in later 
life who might otherwise be lonely. 
Raspberry Pi is for everyone. 

Sunday morning. A quick email 
check, coffee, and breakfast. I create a 
new folder: MK Jam #10. I hope people 
turn up. 


PJ Evans 


When not writing for The MagPi and 
others, PJ supervises the Milton Keynes 
Raspberry Jam and thinks you should 
come along to the next one.. 


mkraspberryjam.org 


Use your Pi to collect 
sensor data to the 
Google Cloud 


OO0O0000 0! 


UrsaLeo 


Download our Raspbian package to 
turn your Pi into a Google cloud 
gateway. Display data on dashboards, 
store and download it, use it to drive 


emails, texts and other alerts. 


LEDs indicate BLE, internet and 


Enter code | magpil cloud connectivity 
at account creation to receive Console interface 
a free Pi debug board” Safe power down switch 


ursaleo.com/raspbian 


*Offer available for North America and Europe only q > sit 


Perfect option for your DYI or high-volume commercial projects 


Fits all kinds of HATs 
Ideal PoE HAT case 


Use with HAT or Pi alone 
Simple and professional 


Rapid, tool-free assembly 
GPIO cable pass-through 


Two wall mount options 
Well ventilated 


Designed and manufactured in North America 


